ASP.NET中Web.Config配置文件详解与应用

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