花了點(diǎn)時(shí)間整理了一下ASP.NET Web.config配置文件的基本使用方法。很適合新手參看,由于Web.config在使用很靈活,可以自定義一些節點(diǎn)。所以這里只介紹一些比較常用的節點(diǎn)。
<?xml version="1.0"?>
<!--注意: 除了手動(dòng)編輯此文件以外,您還可以使用 Web 管理工具來(lái)配置應用程序的設置??梢允褂?Visual Studio 中的“網(wǎng)站”->“Asp.Net 配置”選項。
設置和注釋的完整列表在 machine.config.comments 中,該文件通常位于 "Windows"Microsoft.Net"Framework"v2.x"Config 中。-->
<!--Webconfig文件是一個(gè)xml文件,configuration是xml文件的根節點(diǎn),由于xml文件的根節點(diǎn)只能有一個(gè),所以Webconfig的所有配置都是在這個(gè)節點(diǎn)內進(jìn)行的。-->
<configuration>
<!--指定配置節和命名空間聲明。clear:移除對繼承的節和節組的所有引用,只允許由當前 section 和 sectionGroup 元素添加的節和節組。remove:移除對繼承的節和節組的引用。
section:定義配置節處理程序與配置元素之間的關(guān)聯(lián)。sectionGroup:定義配置節處理程序與配置節之間的關(guān)聯(lián)。-->
<configSections>
<sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
<sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
<section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, 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.RewriterConfigurationSectionHandler, 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;User ID=sa;password=sa"></add>
<add name="111" connectionString="11111" />
</connectionStrings>
<!--指定應用子配置設置的資源,并鎖定配置設置,以防止它們被子配置文件重寫(xiě)。page指定應用包含的配置設置的資源.allowOverride是否允許配置文件的重寫(xiě),提高配置文件的安全性-->
<location path="Default.aspx" allowOverride="false">
<!--控制asp.net運行時(shí)的行為-->
<system.web>
<!--identity控制web應用程序的身份驗證標識.-->
<identity impersonate="false" />
<!--標識特定于頁(yè)的配置設置(如是否啟用會(huì )話(huà)狀態(tài)、視圖狀態(tài),是否檢測用戶(hù)的輸入等)。<pages>可以在計算機、站點(diǎn)、應用程序和子目錄級別聲明.
這里的幾個(gè)屬性的意思是默認主頁(yè)為Index,主題是Default,不檢測用戶(hù)在瀏覽器輸入的內容中是否存在潛在的危險數據(注:該項默認是檢測,如果你使用了不檢測,一要對用戶(hù)的輸入進(jìn)行編碼或驗證),在從客戶(hù)端回發(fā)頁(yè)時(shí)將檢查加密的視圖狀態(tài),以驗證視圖狀態(tài)是否已在客戶(hù)端被篡改。(注:該項默認是不驗證)禁用ViewState-->
<pages masterPageFile="Index" theme="Default" buffer="true" enableViewStateMac="true" validateRequest="false" enableViewState="false">
<!--controls 元素定義標記前綴所在的 register 指令和命名空間的集合-->
<controls></controls>
<!--將在程序集預編譯期間使用的導入指令的集合-->
<namespaces></namespaces>
</pages>
<!--默認錯誤頁(yè)設置,mode:具有On,Off,RemoteOnly 3種狀態(tài)。On表示始終顯示自定義的信息; Off表示始終顯示詳細的asp.net錯誤信息; RemoteOnly表示只對不在本地Web服務(wù)器上運行的用戶(hù)顯示自定義信息.defaultRedirect:用于出現錯誤時(shí)重定向的URL地址-->
<customErrors defaultRedirect="Err.html" mode="RemoteOnly">
<!--特殊代碼編號的錯誤從定向文件-->
<error statusCode="403" redirect="NoAccess.htm" />
<error statusCode="404" redirect="FileNotFound.htm" />
</customErrors>
<!--配置調試和跟蹤:下面配置的意思是啟動(dòng)調試(默認),捕獲跟蹤信息,要緩存的跟蹤請求個(gè)數(15),跟蹤結果的排列順序-->
<trace enabled="true" localOnly="false" pageOutput="true" requestLimit="15" traceMode="SortByCategory"/>
<!-- 設置 compilation debug="true" 將調試符號插入已編譯的頁(yè)面中。但由于這會(huì )影響性能,因此只在開(kāi)發(fā)過(guò)程中將此值設置為 true。設置默認的開(kāi)發(fā)語(yǔ)言C#。batch是否支持批處理-->
<compilation debug="true" defaultLanguage="c#" batch="false">
<assemblies>
<!--加的程序集引用,每添加一個(gè)程序集,就表示你的應用程序已經(jīng)依賴(lài)了一個(gè)程序集,你就可以在你的應用程序中使用了-->
<add assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
<add assembly="System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>
<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, PublicKeyToken=B77A5C561934E089"/>
<add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>
<add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
<add assembly="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
<add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>
<add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
<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>
<!--通過(guò) <authentication> 節可以配置 ASP.NET 使用的 安全身份驗證模式,以標識傳入的用戶(hù)。Windows: 使用IIS驗證方式,Forms: 使用基于窗體的驗證方式,Passport: 采用Passport cookie驗證模式,None: 不采用任何驗證方式-->
<authentication mode="Forms">
<!--Name: 指定完成身份驗證的Http cookie的名稱(chēng).LoginUrl: 如果未通過(guò)驗證或超時(shí)后重定向的頁(yè)面URL,一般為登錄頁(yè)面,讓用戶(hù)重新登錄。Protection: 指定 cookie數據的保護方式.
可設置為:All表示加密數據,并進(jìn)行有效性驗證兩種方式,None表示不保護Cookie,Encryption表示對Cookie內容進(jìn)行加密,validation表示對Cookie內容進(jìn)行有效性驗證,TimeOut: 指定Cookie的失效時(shí)間. 超時(shí)后要重新登錄。-->
<forms name=".ASPXUSERDEMO" loginUrl="Login.aspx" protection="All" timeout="30"/>
</authentication>
<!--控制對 URL 資源的客戶(hù)端訪(fǎng)問(wèn)(如允許匿名用戶(hù)訪(fǎng)問(wèn))。此元素可以在任何級別(計算機、站點(diǎn)、應用程序、子目錄或頁(yè))上聲明。必需與<authentication> 節配合使用。此處的意思是對匿名用戶(hù)不進(jìn)行身份驗證。拒絕用戶(hù)weipeng-->
<authorization>
<allow users="*"/>
<deny users="weipeng"/>
<allow users="aa" roles="aa" />
</authorization>
<!--站點(diǎn)全球化設置,requestEncoding: 它用來(lái)檢查每一個(gè)發(fā)來(lái)請求的編碼.responseEncoding: 用于檢查發(fā)回的響應內容編碼.fileEncoding:用于檢查aspx,asax等文件解析的默認編碼,默認的編碼是utf-8-->
<globalization requestEncoding="gb2312" responseEncoding="gb2312" fileEncoding="gb2312" />
<!--會(huì )話(huà)狀態(tài)設置。mode: 分為off,Inproc,StateServer,SqlServer幾種狀態(tài) mode = InProc 存儲在進(jìn)程中特點(diǎn):具有最佳的性能,速度最快,但不能跨多臺服務(wù)器存儲共享.mode = "StateServer" 存儲在狀態(tài)服務(wù)器中特點(diǎn):當需要跨服務(wù)器維護用戶(hù)會(huì )話(huà)信息時(shí),使用此方法。但是信息存儲在狀態(tài)服務(wù)器上,一旦狀態(tài)服務(wù)器出現故障,信息將丟失. mode="SqlServer" 存儲在sql server中特點(diǎn):工作負載會(huì )變大,但信息不會(huì )丟失
stateConnectionString :指定asp.net應用程序存儲遠程會(huì )話(huà)狀態(tài)的服務(wù)器名,默認為本機。sqlConnectionString:當用會(huì )話(huà)狀態(tài)數據庫時(shí),在這里設置連接字符串。Cookieless:設置為flase時(shí),表示使用cookie會(huì )話(huà)狀態(tài)來(lái)標識客戶(hù).timeout表示會(huì )話(huà)超時(shí)時(shí)間。-->
<sessionState mode="InProc" stateConnectionString="tcpip=127.0.0.1:42424" sqlConnectionString="data source=127.0.0.1;Trusted_Connection=yes" cookieless="false" timeout="20"></sessionState>
<!--為 ASP.NET 應用程序配置頁(yè)的視圖狀態(tài)設置。設置要存儲在頁(yè)歷史記錄中的項數。-->
<sessionPageState historySize="9"/>
<!--配置asp.net http運行庫的設置??梢栽谟嬎銠C,站點(diǎn),應用程序和子目錄級別聲明
允許最多的請求個(gè)數100,最長(cháng)允許執行請求時(shí)間為80秒,控制用戶(hù)上傳文件的大小,默認是4M。useFullyQualifiedRedirectUrl客戶(hù)端重定向不需要被自動(dòng)轉換為完全限定格式。-->
<httpRuntime appRequestQueueLimit="100" executionTimeout="80" maxRequestLength="40960" useFullyQualifiedRedirectUrl="false"/>
<!--httpModules在一個(gè)應用程序內配置 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.WindowsAuthenticationModule" />
<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
<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.AnonymousIdentificationModule" />
<!--自定義的URL重寫(xiě),type基本上就是dll名-->
<add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule, Intelligencia.UrlRewriter" />
<add name="Profile" type="System.Web.Profile.ProfileModule" />
</httpModules>
<!--httpHandlers用于根據用戶(hù)請求的URL和HTTP謂詞將用戶(hù)的請求交給相應的處理程序??梢栽谂渲眉墑e的任何層次配置此節點(diǎn),也就是說(shuō)可以針對某個(gè)特定目錄下指定的特殊文件進(jìn)行特殊處理。
add:指定映射到處理程序的謂詞/路徑。clear:移除當前已配置或已繼承的所有處理程序映射。remove:移除映射到處理程序的謂詞/路徑。remove 指令必須與前一個(gè) add 指令的謂詞/路徑組合完全匹配。該指令不支持通配符。-->
<httpHandlers>
<remove verb="*" path="*.asmx"/>
<add verb="*" path="*.asmx" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
<add verb="*" path="*_AppService.axd" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
<add verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" validate="false"/>
<add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/>
</httpHandlers>
<!--為 Web 應用程序使用的 Cookie 配置屬性。domain:設置 Cookie 域名。httpOnlyCookies:在 Internet Explorer 6 SP1 中啟用 HttpOnlyCookies Cookie 的輸出。默認值為 false。requireSSL:獲取一個(gè)指示是否需要安全套接字層 (SSL) 通信的值.-->
<httpCookies httpOnlyCookies="false" requireSSL="false"/>
<!--控制 ASP.NET Web 服務(wù)及其客戶(hù)端的行為。protocols:指定傳輸協(xié)議,ASP.NET 可使用這些傳輸協(xié)議來(lái)解密 HTTP-->
<webServices>
<protocols>
<add/>
</protocols>
</webServices>
<!--為 Web 應用程序配置緩存設置。cache:定義全局應用程序緩存設置。outputCache :指定應用程序范圍的輸出緩存設置。outputCacheSettings:指定可以應用于應用程序中頁(yè)的輸出緩存設置。sqlCacheDependency:為 ASP.NET 應用程序配置 SQL 緩存依賴(lài)項。-->
<caching>
<cache disableMemoryCollection = "false" disableExpiration = "false" privateBytesLimit = "0" percentagePhysicalMemoryUsedLimit = "90" privateBytesPollTime = "00:02:00"/>
<!--設計需要以這種方式緩存的頁(yè)時(shí),您需要向該頁(yè)添加以下指令:<%@ OutputCache CacheProfile="ServerOnly" %>-->
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly" duration="60" varyByCustom="browser" location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
</caching>
</system.web>
</location>
<!--網(wǎng)絡(luò )設置,authenticationModules:指定用于對 Internet 請求進(jìn)行身份驗證的模塊。connectionManagement:指定與 Internet 宿主的連接的最大數目。defaultProxy:配置超文本傳輸協(xié)議 (HTTP) 代理服務(wù)器。
mailSettings:配置簡(jiǎn)單郵件傳輸協(xié)議 (SMTP) 郵件發(fā)送選項。requestCaching:控制網(wǎng)絡(luò )請求的緩存機制。settings:配置 System.Net 的基本網(wǎng)絡(luò )選項。-->
<system.net>
<!--配置SMTP電子郵件設置-->
<mailSettings>
<smtp from="weipeng">
<network host="Gao" password="" userName="" />
</smtp>
</mailSettings>
<!--禁用所有緩存-->
<requestCaching disableAllCaching="true"></requestCaching>
<!--指定代理地址,并對本地訪(fǎng)問(wèn)和 contoso.com 跳過(guò)代理。-->
<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 相關(guān)的 HTTP 處理程序和模塊。該節使 IIS 7.0 在集成模式下運行時(shí)可使用這些處理程序和模塊。在iis7.0 下運行 ASP.NET AJAX 需要 system.webServer
節。對早期版本的 IIS 來(lái)說(shuō)則不需要此節。 -->
<system.webServer>
<validation validateIntegratedModeConfiguration="false"/>
<modules>
<add name="ScriptModule" preCondition="integratedMode" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
</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" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
<add name="ScriptResource" preCondition="integratedMode" verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
</handlers>
</system.webServer>
<!--ASP.NET AJAX 中配置 ASP.NET 服務(wù)-->
<system.web.extensions>
<!--配置 JSON 序列化-->
<scripting>
<webServices>
<jsonSerialization maxJsonLength="5000"/>
</webServices>
</scripting>
</system.web.extensions>
<!--對WCF的相關(guān)配置-->
<system.serviceModel>
<services>
<service name="WCFStudent.WCFStudentText" behaviorConfiguration="ServiceBehavior">
<!-- Service Endpoints -->
<endpoint address="" binding="wsHttpBinding" contract="WCFStudent.IStuServiceContract">
<!-- 部署時(shí),應刪除或替換下列標識元素,以反映在其下運行部署服務(wù)的標識。刪除之后,WCF 將自動(dòng)推導相應標識。-->
<identity>
<dns value="localhost"/>
</identity>
</endpoint>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="ServiceBehavior">
<!-- 為避免泄漏元數據信息,請在部署前將以下值設置為 false 并刪除上面的元數據終結點(diǎn) -->
<serviceMetadata httpGetEnabled="true"/>
<!-- 要接收故障異常詳細信息以進(jìn)行調試,請將以下值設置為 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>
聯(lián)系客服