Web.config配置文件詳解
花了點時間整理了一下ASP.NET Web.config配置文件的基本使用方法。很適合新手參看,由于Web.config在使用很靈活,可以自定義一些節點。所以這里只介紹一些比較常用的節點。
<?xml version="1.0"?> <!--注意: 除了手動編輯此文件以外,您還可以使用 Web 管理工具來配置應用程序的設置。可以使用 Visual Studio 中 的“網站”->“Asp.Net 配置”選項。 設置和注釋的完整列表在 machine.config.comments 中,該文件通常位于 "Windows"Microsoft.Net"Framewo rk"v2.x"Config 中。--> <!--Webconfig文件是一個xml文件,configuration是xml文件的根節點,由于xml文件的根節點只能有一個,所以 Webconfig的所有配置都是在這個節點內進行的。--> <configuration> <!--指定配置節和命名空間聲明。clear:移除對繼承的節和節組的所有引用,只允許由當前 section 和 sectionGroup 元素添加的節和節組。remove:移除對繼承的節和節組的引用。 section:定義配置節處理程序與配置元素之間的關聯。sectionGroup:定義配置節處理程序與配置節之間的關聯。--> <configSections> <sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWeb ExtensionsSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicK eyToken=31bf3856ad364e35"> <sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, Sys tem.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e3 5"> <section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptRe sourceHandlerSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="MachineToApplication"/> </sectionGroup> </sectionGroup> <section name="rewriter" type="Intelligencia.UrlRewriter.Configuration.RewriterConfigurationSe ctionHandler, Intelligencia.UrlRewriter" /> </configSections> <!--appSettings是應用程序設置,可以定義應用程序的全局常量設置等信息--> <appSettings> <add key="1" value="1" /> <add key="gao" value="weipeng" /> </appSettings> <!--連接字符串設置--> <connectionStrings> <add name="ConnString" connectionString="Data Source=GAO;Initial Catalog=HBWXDate;Us er ID=sa;password=sa"></add> <add name="111" connectionString="11111" /> </connectionStrings> <!--指定應用子配置設置的資源,并鎖定配置設置,以防止它們被子配置文件重寫。page指定應用包含的配置設置的資源 .allowOverride是否允許配置文件的重寫,提高配置文件的安全性--> <location path="Default.aspx" allowOverride="false"> <!--控制asp.net運行時的行為--> <system.web> <!--identity控制web應用程序的身份驗證標識.--> <identity impersonate="false" /> <!--標識特定于頁的配置設置(如是否啟用會話狀態、視圖狀態,是否檢測用戶的輸入等)。<pages>可以在計算機、 站點、應用程序和子目錄級別聲明. 這里的幾個屬性的意思是默認主頁為Index,主題是Default,不檢測用戶在瀏覽器輸入的內容中是否存在潛在的危險數 據(注:該項默認是檢測,如果你使用了不檢測,一要對用戶的輸入進行編碼或驗證),在從客戶端回發頁時將檢查加密的視 圖狀態,以驗證視圖狀態是否已在客戶端被篡改。(注:該項默認是不驗證)禁用ViewState--> <pages masterPageFile="Index" theme="Default" buffer="true" enableViewStateMac="true" validateRequest="false" enableViewState="false"> <!--controls 元素定義標記前綴所在的 register 指令和命名空間的集合--> <controls></controls> <!--將在程序集預編譯期間使用的導入指令的集合--> <namespaces></namespaces> </pages> <!--默認錯誤頁設置,mode:具有On,Off,RemoteOnly 3種狀態。On表示始終顯示自定義的信息; Off表示始終 顯示詳細的asp.net錯誤信息; RemoteOnly表示只對不在本地Web服務器上運行的用戶顯示自定義信息.defaultRed irect:用于出現錯誤時重定向的URL地址--> <customErrors defaultRedirect="Err.html" mode="RemoteOnly"> <!--特殊代碼編號的錯誤從定向文件--> <error statusCode="403" redirect="NoAccess.htm" /> <error statusCode="404" redirect="FileNotFound.htm" /> </customErrors> <!--配置調試和跟蹤:下面配置的意思是啟動調試(默認),捕獲跟蹤信息,要緩存的跟蹤請求個數(15),跟蹤結果的排列順序--> <trace enabled="true" localOnly="false" pageOutput="true" requestLimit="15" traceMode=" SortByCategory"/> <!-- 設置 compilation debug="true" 將調試符號插入已編譯的頁面中。但由于這會影響性能,因此只在開發過 程中將此值設置為 true。設置默認的開發語言C#。batch是否支持批處理--> <compilation debug="true" defaultLanguage="c#" batch="false"> <assemblies> <!--加的程序集引用,每添加一個程序集,就表示你的應用程序已經依賴了一個程序集,你就可以在你的應用程序 中使用了--> <add assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKe yToken=31bf3856ad364e35"/> <add assembly="System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03 F5F7F11D50A3A"/> <add assembly="System.Web.Extensions.Design, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/> <add assembly="System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyTok en=B77A5C561934E089"/> <add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7 F11D50A3A"/> <add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561 934E089"/> <add assembly="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C 561934E089"/> <add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03 F5F7F11D50A3A"/> <add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C 561934E089"/> <add assembly="System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken =B03F5F7F11D50A3A"/> <add assembly="System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/> </assemblies> <!--定義用于編譯自定義資源文件的生成提供程序的集合。--> <buildProviders> <!----> <add extension=".aspx" type="System.Web.Compilation.PageBuildProvider"/> <add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider"/> <add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider"/> <add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider"/> <add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider"/> <add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider"/> <add extension=".resx" type="System.Web.Compilation.ResXBuildProvider"/> <add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider"/> <add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider"/> <add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/> <add extension=".rdlc" type="Microsoft.Reporting.RdlBuildProvider, Microsoft.ReportViewer .Common, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/> </buildProviders> </compilation> <!--通過 <authentication> 節可以配置 ASP.NET 使用的 安全身份驗證模式,以標識傳入的用戶。Windows: 使用IIS驗證方式,Forms: 使用基于窗體的驗證方式,Passport: 采用Passport cookie驗證模式,None: 不采用任何 驗證方式--> <authentication mode="Forms"> <!--Name: 指定完成身份驗證的Http cookie的名稱.LoginUrl: 如果未通過驗證或超時后重定向的頁面URL,一 般為登錄頁面,讓用戶重新登錄。Protection: 指定 cookie數據的保護方式. 可設置為:All表示加密數據,并進行有效性驗證兩種方式,None表示不保護Cookie,Encryption表示對Cookie內 容進行加密,validation表示對Cookie內容進行有效性驗證,TimeOut: 指定Cookie的失效時間. 超時后要重新登錄 。--> <forms name=".ASPXUSERDEMO" loginUrl="Login.aspx" protection="All" timeout="30"/> </authentication> <!--控制對 URL 資源的客戶端訪問(如允許匿名用戶訪問)。此元素可以在任何級別(計算機、站點、應用程序、子目錄或頁)上聲明。必需與<authentication> 節配合使用。此處的意思是對匿名用戶不進行身份驗證。拒絕用戶weipeng--> <authorization> <allow users="*"/> <deny users="weipeng"/> <allow users="aa" roles="aa" /> </authorization> <!--站點全球化設置,requestEncoding: 它用來檢查每一個發來請求的編碼.responseEncoding: 用于檢查發回 的響應內容編碼.fileEncoding:用于檢查aspx,asax等文件解析的默認編碼,默認的編碼是utf-8--> <globalization requestEncoding="gb2312" responseEncoding="gb2312" fileEncoding="gb2312" /> <!--會話狀態設置。mode: 分為off,Inproc,StateServer,SqlServer幾種狀態 mode = InProc 存儲在進程中 特點:具有最佳的性能,速度最快,但不能跨多臺服務器存儲共享.mode = "StateServer" 存儲在狀態服務器中特點:當 需要跨服務器維護用戶會話信息時,使用此方法。但是信息存儲在狀態服務器上,一旦狀態服務器出現故障,信息將丟失. mode="SqlServer" 存儲在sql server中特點:工作負載會變大,但信息不會丟失 stateConnectionString :指定asp.net應用程序存儲遠程會話狀態的服務器名,默認為本機。sqlConnectionStri ng:當用會話狀態數據庫時,在這里設置連接字符串。Cookieless:設置為flase時,表示使用cookie會話狀態來標識客戶 .timeout表示會話超時時間。--> <sessionState mode="InProc" stateConnectionString="tcpip=127.0.0.1:42424" sqlConnectionS tring="data source=127.0.0.1;Trusted_Connection=yes" cookieless="false" timeout="20"></ses sionState> <!--為 ASP.NET 應用程序配置頁的視圖狀態設置。設置要存儲在頁歷史記錄中的項數。--> <sessionPageState historySize="9"/> <!--配置asp.net http運行庫的設置。可以在計算機,站點,應用程序和子目錄級別聲明 允許最多的請求個數100,最長允許執行請求時間為80秒,控制用戶上傳文件的大小,默認是4M。useFullyQualifie dRedirectUrl客戶端重定向不需要被自動轉換為完全限定格式。--> <httpRuntime appRequestQueueLimit="100" executionTimeout="80" maxRequestLength="4 0960" useFullyQualifiedRedirectUrl="false"/> <!--httpModules在一個應用程序內配置 HTTP 模塊。--> <httpModules> <add name="OutputCache" type="System.Web.Caching.OutputCacheModule" /> <add name="Session" type="System.Web.SessionState.SessionStateModule" /> <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationM odule" /> <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" /> <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationMo dule" /> <add name="RoleManager" type="System.Web.Security.RoleManagerModule" /> <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" /> <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" /> <add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificatio nModule" /> <!--自定義的URL重寫,type基本上就是dll名--> <add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule, Intelligencia.U rlRewriter" /> <add name="Profile" type="System.Web.Profile.ProfileModule" /> </httpModules> <!--httpHandlers用于根據用戶請求的URL和HTTP謂詞將用戶的請求交給相應的處理程序。可以在配置級別的任何 層次配置此節點,也就是說可以針對某個特定目錄下指定的特殊文件進行特殊處理。 add:指定映射到處理程序的謂詞/路徑。clear:移除當前已配置或已繼承的所有處理程序映射。remove:移除映射到 處理程序的謂詞/路徑。remove 指令必須與前一個 add 指令的謂詞/路徑組合完全匹配。該指令不支持通配符。--> <httpHandlers> <remove verb="*" path="*.asmx"/> <add verb="*" path="*.asmx" validate="false" type="System.Web.Script.Services.ScriptHandl erFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3 856ad364e35"/> <add verb="*" path="*_AppService.axd" validate="false" type="System.Web.Script.Services. ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKey Token=31bf3856ad364e35"/> <add verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResou rceHandler, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31 bf3856ad364e35" validate="false"/> <add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/> </httpHandlers> <!--為 Web 應用程序使用的 Cookie 配置屬性。domain:設置 Cookie 域名。httpOnlyCookies:在 Interne t Explorer 6 SP1 中啟用 HttpOnlyCookies Cookie 的輸出。默認值為 false。requireSSL:獲取一個指示是否需 要安全套接字層 (SSL) 通信的值.--> <httpCookies httpOnlyCookies="false" requireSSL="false"/> <!--控制 ASP.NET Web 服務及其客戶端的行為。protocols:指定傳輸協議,ASP.NET 可使用這些傳輸協議來解 密 HTTP--> <webServices> <protocols> <add/> </protocols> </webServices> <!--為 Web 應用程序配置緩存設置。cache:定義全局應用程序緩存設置。outputCache :指定應用程序范圍的輸 出緩存設置。outputCacheSettings:指定可以應用于應用程序中頁的輸出緩存設置。 sqlCacheDependency:為 AS P.NET 應用程序配置 SQL 緩存依賴項。--> <caching> <cache disableMemoryCollection = "false" disableExpiration = "false" privateBytesLimit = "0" percentagePhysicalMemoryUsedLimit = "90" privateBytesPollTime = "00:02:00"/> <!--設計需要以這種方式緩存的頁時,您需要向該頁添加以下指令:<%@ OutputCache CacheProfile="Ser verOnly" %>--> <outputCacheSettings> <outputCacheProfiles> <add name="ServerOnly" duration="60" varyByCustom="browser" location="Server" /> </outputCacheProfiles> </outputCacheSettings> </caching> </system.web> </location> <!--網絡設置,authenticationModules:指定用于對 Internet 請求進行身份驗證的模塊。connectionManage ment:指定與 Internet 宿主的連接的最大數目。defaultProxy:配置超文本傳輸協議 (HTTP) 代理服務器。 mailSettings:配置簡單郵件傳輸協議 (SMTP) 郵件發送選項。requestCaching:控制網絡請求的緩存機制。setti ngs:配置 System.Net 的基本網絡選項。--> <system.net> <!--配置SMTP電子郵件設置--> <mailSettings> <smtp from="weipeng"> <network host="Gao" password="" userName="" /> </smtp> </mailSettings> <!--禁用所有緩存--> <requestCaching disableAllCaching="true"></requestCaching> <!--指定代理地址,并對本地訪問和 contoso.com 跳過代理。--> <defaultProxy> <proxy usesystemdefault="True" proxyaddress="http://192.168.1.10:3128" bypassonlocal= "True"/> <bypasslist> <add address="[a-z]+".contoso".com" /> </bypasslist> </defaultProxy> </system.net> <!--該節替換在 httpHandlers 和 httpModules 節中添加的與 AJAX 相關的 HTTP 處理程序和模塊。該節使 IIS 7.0 在集成模式下運行時可使用這些處理程序和模塊。在iis7.0 下運行 ASP.NET AJAX 需要 system.webServer 節。對早期版本的 IIS 來說則不需要此節。 --> <system.webServer> <validation validateIntegratedModeConfiguration="false"/> <modules> <add name="ScriptModule" preCondition="integratedMode" type="System.Web.Handlers.Scri ptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856 AD364E35"/> </modules> <handlers> <remove name="WebServiceHandlerFactory-Integrated"/> <add name="ScriptHandlerFactory" verb="*" path="*.asmx" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/> <add name="ScriptHandlerFactoryAppServices" verb="*" path="*_AppService.axd" preCondit ion="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Exte nsions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/> <add name="ScriptResource" preCondition="integratedMode" verb="GET,HEAD" path="Script Resource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Ve rsion=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/> </handlers> </system.webServer> <!--ASP.NET AJAX 中配置 ASP.NET 服務--> <system.web.extensions> <!--配置 JSON 序列化--> <scripting> <webServices> <jsonSerialization maxJsonLength="5000"/> </webServices> </scripting> </system.web.extensions> <!--對WCF的相關配置--> <system.serviceModel> <services> <service name="WCFStudent.WCFStudentText" behaviorConfiguration="ServiceBehavior"> <!-- Service Endpoints --> <endpoint address="" binding="wsHttpBinding" contract="WCFStudent.IStuServiceContract"> <!-- 部署時,應刪除或替換下列標識元素,以反映在其下運行部署服務的標識。刪除之后,WCF 將自動推導相應 標識。--> <identity> <dns value="localhost"/> </identity> </endpoint> <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/> </service> </services> <behaviors> <serviceBehaviors> <behavior name="ServiceBehavior"> <!-- 為避免泄漏元數據信息,請在部署前將以下值設置為 false 并刪除上面的元數據終結點 --> <serviceMetadata httpGetEnabled="true"/> <!-- 要接收故障異常詳細信息以進行調試,請將以下值設置為 true。在部署前設置為 false 以避免泄漏異常信息--> <serviceDebug includeExceptionDetailInFaults="false"/> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> <!--URL重定向--> <rewriter> <rewrite url="~/user/u(.+).aspx" to="~/user/index.aspx?r=$1" /> <rewrite url="~/ask/q(.+).aspx" to="~/home/ask/content.aspx?id=$1" /> <rewrite url="~/blog/b(.+).aspx" to="~/home/blog/article.aspx?r=$1" /> <rewrite url="~/news/n(.+).aspx" to="~/home/news/content.aspx?nid=$1" /> <rewrite url="~/default.aspx" to="~/home/ram/net.aspx" /> </rewriter> </configuration>
全站熱搜