你的位置:首页 > ASP.net教程

[ASP.net教程]WebConfig配置文件有哪些不为人知的秘密?


 1 <?"1.0"?>      这小哥写的挺好的,一直想弄明白web.config 的具体用途,特意转载一下: 2  3 <!--注意: 除了手动编辑此文件以外,您还可以使用 Web 管理工具来配置应用程序的设置。可以使用 Visual Studio 中的“网站”->“Asp.Net 配置”选项。 4  5 设置和注释的完整列表在 machine.config.comments 中,该文件通常位于 "Windows"Microsoft.Net"Framework"v2.x"Config 中。--> 6  7 <!--Webconfig文件是一个 8  9 <configuration> 10  11  <!--指定配置节和命名空间声明。clear:移除对继承的节和节组的所有引用,只允许由当前 section 和 sectionGroup 元素添加的节和节组。remove:移除对继承的节和节组的引用。 12  13 section:定义配置节处理程序与配置元素之间的关联。sectionGroup:定义配置节处理程序与配置节之间的关联。--> 14  15 <configSections> 16  17   <sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"> 18  19    <sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"> 20  21     <section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false" allowDefinition="MachineToApplication"/> 22  23    </sectionGroup> 24  25   </sectionGroup> 26  27   <section name="rewriter" type="Intelligencia.UrlRewriter.Configuration.RewriterConfigurationSectionHandler, Intelligencia.UrlRewriter" /> 28  29 </configSections> 30  31  32  33 <!--appSettings是应用程序设置,可以定义应用程序的全局常量设置等信息--> 34  35   <appSettings> 36  37 <add key="1" value="1" /> 38  39 <add key="gao" value="weipeng" /> 40  41 </appSettings> 42  43  44  45 <!--连接字符串设置--> 46  47 <connectionStrings> 48  49   <add name="ConnString" connectionString="Data Source=GAO;Initial Catalog=HBWXDate;User ID=sa;password=sa"></add> 50  51   <add name="111" connectionString="11111" /> 52  53 </connectionStrings> 54  55  56  57 <!--指定应用子配置设置的资源,并锁定配置设置,以防止它们被子配置文件重写。page指定应用包含的配置设置的资源.allowOverride是否允许配置文件的重写,提高配置文件的安全性--> 58  59 <location path="Default.aspx" allowOverride="false"> 60  61   <!--控制asp.net运行时的行为--> 62  63 <system.web> 64  65   <!--identity控制web应用程序的身份验证标识.--> 66  67   <identity impersonate="false" /> 68  69   70  71   <!--标识特定于页的配置设置(如是否启用会话状态、视图状态,是否检测用户的输入等)。<pages>可以在计算机、站点、应用程序和子目录级别声明. 72  73   这里的几个属性的意思是默认主页为Index,主题是Default,不检测用户在浏览器输入的内容中是否存在潜在的危险数据(注:该项默认是检测,如果你使用了不检测,一要对用户的输入进行编码或验证),在从客户端回发页时将检查加密的视图状态,以验证视图状态是否已在客户端被篡改。(注:该项默认是不验证)禁用ViewState--> 74  75   <pages masterPageFile="Index" theme="Default" buffer="true" enableViewStateMac="true" validateRequest="false" enableViewState="false"> 76  77    <!--controls 元素定义标记前缀所在的 register 指令和命名空间的集合--> 78  79    <controls></controls> 80  81    <!--将在程序集预编译期间使用的导入指令的集合--> 82  83    <namespaces></namespaces> 84  85   </pages> 86  87   88  89   <!--默认错误页设置,mode:具有On,Off,RemoteOnly 3种状态。On表示始终显示自定义的信息; Off表示始终显示详细的asp.net错误信息; RemoteOnly表示只对不在本地Web服务器上运行的用户显示自定义信息.defaultRedirect:用于出现错误时重定向的URL地址--> 90  91   <customErrors defaultRedirect="Err.html" mode="RemoteOnly"> 92  93    <!--特殊代码编号的错误从定向文件--> 94  95    <error statusCode="403" redirect="NoAccess.htm" /> 96  97    <error statusCode="404" redirect="FileNotFound.htm" /> 98  99   </customErrors>100 101  102 103   <!--配置调试和跟踪:下面配置的意思是启动调试(默认),捕获跟踪信息,要缓存的跟踪请求个数(15),跟踪结果的排列顺序-->104 105   <trace enabled="true" localOnly="false" pageOutput="true" requestLimit="15" traceMode="SortByCategory"/>106 107  108 109   <!-- 设置 compilation debug="true" 将调试符号插入已编译的页面中。但由于这会影响性能,因此只在开发过程中将此值设置为 true。设置默认的开发语言C#。batch是否支持批处理-->110 111   <compilation debug="true" defaultLanguage="c#" batch="false">112 113    <assemblies>114 115     <!--加的程序集引用,每添加一个程序集,就表示你的应用程序已经依赖了一个程序集,你就可以在你的应用程序中使用了-->116 117     <add assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>118 119     <add assembly="System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>120 121     <add assembly="System.Web.Extensions.Design, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>122 123     <add assembly="System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>124 125     <add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>126 127     <add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>128 129     <add assembly="System."/>130 131     <add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>132 133     <add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>134 135     <add assembly="System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>136 137     <add assembly="System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"/>138 139    </assemblies>140 141    <!--定义用于编译自定义资源文件的生成提供程序的集合。-->142 143    <buildProviders>144 145     <!---->146 147     <add extension=".aspx" type="System.Web.Compilation.PageBuildProvider"/>148 149     <add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider"/>150 151     <add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider"/>152 153     <add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider"/>154 155     <add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider"/>156 157     <add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider"/>158 159     <add extension=".resx" type="System.Web.Compilation.ResXBuildProvider"/>160 161     <add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider"/>162 163     <add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider"/>164 165     <add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"/>166 167     <add extension=".rdlc" type="Microsoft.Reporting.RdlBuildProvider, Microsoft.ReportViewer.Common, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>168 169    </buildProviders>170 171   </compilation>172 173  174 175    <!--通过 <authentication> 节可以配置 ASP.NET 使用的 安全身份验证模式,以标识传入的用户。Windows: 使用IIS验证方式,Forms: 使用基于窗体的验证方式,Passport: 采用Passport cookie验证模式,None: 不采用任何验证方式-->176 177   <authentication mode="Forms">178 179    <!--Name: 指定完成身份验证的Http cookie的名称.LoginUrl: 如果未通过验证或超时后重定向的页面URL,一般为登录页面,让用户重新登录。Protection: 指定 cookie数据的保护方式. 180 181    可设置为:All表示加密数据,并进行有效性验证两种方式,None表示不保护Cookie,Encryption表示对Cookie内容进行加密,validation表示对Cookie内容进行有效性验证,TimeOut: 指定Cookie的失效时间. 超时后要重新登录。-->182 183    <forms name=".ASPXUSERDEMO" loginUrl="Login.aspx" protection="All" timeout="30"/>184 185   </authentication>186 187   <!--控制对 URL 资源的客户端访问(如允许匿名用户访问)。此元素可以在任何级别(计算机、站点、应用程序、子目录或页)上声明。必需与<authentication> 节配合使用。此处的意思是对匿名用户不进行身份验证。拒绝用户weipeng-->188 189   <authorization>190 191    <allow users="*"/>192 193    <deny users="weipeng"/>194 195    <allow users="aa" roles="aa" />196 197   </authorization>198 199   <!--站点全球化设置,requestEncoding: 它用来检查每一个发来请求的编码.responseEncoding: 用于检查发回的响应内容编码.fileEncoding:用于检查aspx,asax等文件解析的默认编码,默认的编码是utf-8-->200 201   <globalization requestEncoding="gb2312" responseEncoding="gb2312" fileEncoding="gb2312" />202 203   <!--会话状态设置。mode: 分为off,Inproc,StateServer,SqlServer几种状态 mode = InProc 存储在进程中特点:具有最佳的性能,速度最快,但不能跨多台服务器存储共享.mode = "StateServer" 存储在状态服务器中特点:当需要跨服务器维护用户会话信息时,使用此方法。但是信息存储在状态服务器上,一旦状态服务器出现故障,信息将丢失. mode="SqlServer" 存储在sql server中特点:工作负载会变大,但信息不会丢失204 205   stateConnectionString :指定asp.net应用程序存储远程会话状态的服务器名,默认为本机。sqlConnectionString:当用会话状态数据库时,在这里设置连接字符串。Cookieless:设置为flase时,表示使用cookie会话状态来标识客户.timeout表示会话超时时间。-->206 207   <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>208 209   <!--为 ASP.NET 应用程序配置页的视图状态设置。设置要存储在页历史记录中的项数。-->210 211   <sessionPageState historySize="9"/>  212 213   <!--配置asp.net http运行库的设置。可以在计算机,站点,应用程序和子目录级别声明214 215   允许最多的请求个数100,最长允许执行请求时间为80秒,控制用户上传文件的大小,默认是4M。useFullyQualifiedRedirectUrl客户端重定向不需要被自动转换为完全限定格式。-->216 217   <httpRuntime appRequestQueueLimit="100" executionTimeout="80" maxRequestLength="40960" useFullyQualifiedRedirectUrl="false"/>218 219   <!--httpModules在一个应用程序内配置 HTTP 模块。-->220 221   <httpModules>222 223    <add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />224 225    <add name="Session" type="System.Web.SessionState.SessionStateModule" />226 227    <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />228 229    <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />230 231    <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />232 233    <add name="RoleManager" type="System.Web.Security.RoleManagerModule" />234 235    <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />236 237    <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />238 239    <add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificationModule" />240 241    <!--自定义的URL重写,type基本上就是dll名-->242 243    <add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule, Intelligencia.UrlRewriter" />244 245    <add name="Profile" type="System.Web.Profile.ProfileModule" />246 247   </httpModules> 248 249   <!--httpHandlers用于根据用户请求的URL和HTTP谓词将用户的请求交给相应的处理程序。可以在配置级别的任何层次配置此节点,也就是说可以针对某个特定目录下指定的特殊文件进行特殊处理。250 251   add:指定映射到处理程序的谓词/路径。clear:移除当前已配置或已继承的所有处理程序映射。remove:移除映射到处理程序的谓词/路径。remove 指令必须与前一个 add 指令的谓词/路径组合完全匹配。该指令不支持通配符。-->252 253   <httpHandlers>254 255    <remove verb="*" path="*.asmx"/>256 257    <add verb="*" path="*.asmx" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>258 259    <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"/>260 261    <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"/>262 263    <add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/>264 265   </httpHandlers>266 267   <!--为 Web 应用程序使用的 Cookie 配置属性。domain:设置 Cookie 域名。httpOnlyCookies:在 Internet Explorer 6 SP1 中启用 HttpOnlyCookies Cookie 的输出。默认值为 false。requireSSL:获取一个指示是否需要安全套接字层 (SSL) 通信的值.-->268 269   <httpCookies httpOnlyCookies="false" requireSSL="false"/> 270 271   <!--控制 ASP.NET Web 服务及其客户端的行为。protocols:指定传输协议,ASP.NET 可使用这些传输协议来解密 HTTP-->272 273   <webServices>274 275    <protocols>276 277     <add/>278 279    </protocols>280 281   </webServices>282 283   <!--为 Web 应用程序配置缓存设置。cache:定义全局应用程序缓存设置。outputCache :指定应用程序范围的输出缓存设置。outputCacheSettings:指定可以应用于应用程序中页的输出缓存设置。sqlCacheDependency:为 ASP.NET 应用程序配置 SQL 缓存依赖项。-->284 285   <caching>286 287    <cache disableMemoryCollection = "false" disableExpiration = "false" privateBytesLimit = "0" percentagePhysicalMemoryUsedLimit = "90" privateBytesPollTime = "00:02:00"/>288 289    <!--设计需要以这种方式缓存的页时,您需要向该页添加以下指令:<%@ OutputCache CacheProfile="ServerOnly" %>-->290 291    <outputCacheSettings>292 293     <outputCacheProfiles>294 295      <add name="ServerOnly" duration="60" varyByCustom="browser" location="Server" />296 297     </outputCacheProfiles>298 299    </outputCacheSettings>300 301   </caching>302 303   </system.web>304 305 </location>306 307 <!--网络设置,authenticationModules:指定用于对 Internet 请求进行身份验证的模块。connectionManagement:指定与 Internet 宿主的连接的最大数目。defaultProxy:配置超文本传输协议 (HTTP) 代理服务器。308 309 mailSettings:配置简单邮件传输协议 (SMTP) 邮件发送选项。requestCaching:控制网络请求的缓存机制。settings:配置 System.Net 的基本网络选项。-->310 311 <system.net>312 313 <!--配置SMTP电子邮件设置-->314 315 <mailSettings>316 317  <smtp from="weipeng">318 319   <network host="Gao" password="" userName="" />320 321  </smtp>322 323 </mailSettings>324 325  <!--禁用所有缓存-->326 327  <requestCaching disableAllCaching="true"></requestCaching>328 329  <!--指定代理地址,并对本地访问和 contoso.com 跳过代理。-->330 331  <defaultProxy>332 333   <proxy usesystemdefault="True" proxyaddress="http://192.168.1.10:3128" bypassonlocal="True"/>334 335   <bypasslist>336 337    <add address="[a-z]+".contoso".com" />338 339   </bypasslist>340 341  </defaultProxy>342 343 </system.net>344 345 <!--该节替换在 httpHandlers 和 httpModules 节中添加的与 AJAX 相关的 HTTP 处理程序和模块。该节使 IIS 7.0 在集成模式下运行时可使用这些处理程序和模块。在iis7.0 下运行 ASP.NET AJAX 需要 system.webServer346 347 节。对早期版本的 IIS 来说则不需要此节。 -->348 349 <system.webServer>350 351   <validation validateIntegratedModeConfiguration="false"/>352 353   <modules>354 355    <add name="ScriptModule" preCondition="integratedMode" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>356 357   </modules>358 359   <handlers>360 361    <remove name="WebServiceHandlerFactory-Integrated"/>362 363    <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"/>364 365    <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"/>366 367    <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"/>368 369   </handlers>370 371 </system.webServer>372 373 374 375 <!--ASP.NET AJAX 中配置 ASP.NET 服务-->376 377 <system.web.extensions>378 379   <!--配置 JSON 序列化-->380 381   <scripting>382 383    <webServices>384 385     <jsonSerialization maxJsonLength="5000"/>386 387    </webServices>388 389   </scripting>390 391 </system.web.extensions>392 393 <!--对WCF的相关配置-->394 395 <system.serviceModel>396 397   <services>398 399    <service name="WCFStudent.WCFStudentText" behaviorConfiguration="ServiceBehavior">400 401     <!-- Service Endpoints -->402 403     <endpoint address="" binding="wsHttpBinding" contract="WCFStudent.IStuServiceContract">404 405      <!-- 部署时,应删除或替换下列标识元素,以反映在其下运行部署服务的标识。删除之后,WCF 将自动推导相应标识。-->406 407      <identity>408 409       <dns value="localhost"/>410 411      </identity>412 413     </endpoint>414 415     <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>416 417    </service>418 419   </services>420 421   <behaviors>422 423    <serviceBehaviors>424 425     <behavior name="ServiceBehavior">426 427      <!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false 并删除上面的元数据终结点 -->428 429      <serviceMetadata httpGetEnabled="true"/>430 431      <!-- 要接收故障异常详细信息以进行调试,请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息-->432 433      <serviceDebug includeExceptionDetailInFaults="false"/>434 435     </behavior>436 437    </serviceBehaviors>438 439   </behaviors>440 441 </system.serviceModel>442 443 444 445 <!--URL重定向-->446 447 <rewriter>448 449   <rewrite url="~/user/u(.+).aspx" to="~/user/index.aspx?r=$1" />450 451   <rewrite url="~/ask/q(.+).aspx" to="~/home/ask/content.aspx?id=$1" />452 453   <rewrite url="~/blog/b(.+).aspx" to="~/home/blog/article.aspx?r=$1" />454 455   <rewrite url="~/news/n(.+).aspx" to="~/home/news/content.aspx?nid=$1" />456 457   <rewrite url="~/default.aspx" to="~/home/ram/net.aspx" />458 459 </rewriter>460 461 </configuration>