ASP.NET2005 Web.config详解

 

<?xml version="1.0" encoding="utf-8" ?>
<configuration> 所有.NET配置文件所必须的根元素
<system.web> 实际ASP.NET配置设置的根元素

<!-- 动态调试编译
设置 compilation debug="true" 以启用 ASPX 调试。
否则，将此值设置为 false 将提高此应用程序的运行时性能。
设置 compilation debug="true" 以将调试符号(.pdb 信息)插入到编译页中。
因为这将创建执行起来较慢的大文件，所以应该只在调试时将此值设置为 true，而在所有其他时候都设置为false。
defaultLanguage="c#" 指定动态编译时使用的默认编程语言，它的值可以是compilers标记定义的任何语言。
tempDirectory 指编译过程中存储文件的目录
-->

<compilation defaultLanguage="c#" debug="true" />

<!-- 自定义错误信息
设置 customErrors mode="On" 或 "RemoteOnly" 以启用自定义错误信息，
或设置为 "Off" 以禁用自定义错误信息。 为每个要处理的错误添加 <error> 标记。
"On" 始终显示自定义(友好的)信息。
如果没有提供defaultRedirect属性,则用户将看到一般的错误信息.
"Off" 始终显示详细的 ASP.NET 错误信息。显示全部的错误细节
"RemoteOnly" 只对不在本地 Web 服务器上运行的用户显示自定义(友好的)信息。
出于安全目的，建议使用此设置，以便不向远程客户端显示应用程序的详细信息。
-->

<customErrors mode="RemoteOnly" />

使用customErrors 元素，可以配置应用程序响应各种HTTP错误时的行为。
例如，通过如下代码，当发生404错误时，就可以把页面重新导向一个友好的页面。

<customErrors defaultRedirect=”standarderror.aspx” mode="remoteonly">
<error statuscode=”404” redirect=”filenotfound.htm”/>
</customErrors>

当发生HTTP错误时，上面的代码将把用户导向standarderror.aspx页面。
如果错误是代码404(即没有发现文件),将把用户导向filenotfound.htm。
但是,由于模式设置为remoteonly，所有本地的管理员将会看到真实的错误信息，
而不是被导向其它的页面，但远程的客户将会看到自定义的错误页面。

<!-- 身份验证
此节设置应用程序的身份验证策略。
可能的模式是 "Windows"、 "Forms"、 "Passport" 和 "None"
"None" 不执行身份验证。
"Windows" IIS 根据应用程序的设置执行身份验证 包含全部的IIS身份验证，此外，NTFS在文件和目录上的权限将决定对目录中资源的访问。
(基本、简要或集成 Windows)。在 IIS 中必须禁用匿名访问。
"Forms" 您为用户提供一个输入凭据的自定义窗体(Web 页)，
然后在您的应用程序中验证他们的身份。用户凭据标记存储在 Cookie 中。
使用cookies去指出授权用户。
"Passport" 身份验证是通过 Microsoft 的集中身份验证服务执行的，
它为成员站点提供单独登录和核心配置文件服务。
-->

<authentication mode="Windows" />

下面是使用Passport的身份验证的示例。
在这个对目录进行配置的示例中，如果用户没有提供有效的Passport，则把用户导向login.aspx页面。

<authentication mode=”Passport”>
<passport redirectUrl=”login.aspx”/>
</authentication>

下面的示例阐明了怎样使用基于窗体的身份验证，以及怎样把有效的用户名和密码保存在配置文件中：

<authentication mode=”Forms”>
 <Forms name=”SecureApplication” loginUrl=”/secureapplication/custlogin.aspx/”>
  <credentials passwordFormat=”Clear”>
   <user name=”admin” password=”admin”/>
  </credentials>
 </forms>
</authentication>

<!-- 授权
此节设置应用程序的授权策略。可以允许或拒绝不同的用户或角色访问应用程序资源。
通配符: "*" 表示任何人，"?" 表示匿名(未经身份验证的)用户。
-->

<authorization>
 <allow users="*" /> <!-- 允许所有用户 -->
 <!-- <allow users="[逗号分隔的用户列表]"
 roles="[逗号分隔的角色列表]"/>
 <deny users="[逗号分隔的用户列表]"
 roles="[逗号分隔的角色列表]"/>
 -->
</authorization>

<!-- 应用程序级别跟踪记录
应用程序级别跟踪为应用程序中的每一页启用跟踪日志输出。
设置 trace enabled="true" 可以启用应用程序跟踪记录。
如果 pageOutput="true"，则 在每一页的底部显示跟踪信息。
否则，可以通过浏览 Web 应用程序根目录中的 "trace.axd" 页来查看应用程序跟踪日志。
-->

<trace enabled="false" requestLimit="10" pageOutput="false" traceMode="SortByTime" localOnly="true" />

默认状态下，trace元素处于激活状态，但是它的输出没有显示给Web页面。
在trace元素中也可以定义侦听器，侦听器其实是一些对象，使用那些对象，可以收听、收集和发送各种消息。
下面代码中定义的侦听器可以把跟踪信息写到日志文件（即文本文件中）：

<trace enabled="true" requestLimit=”10” pageOutput=”false”>
 <listeners>
  <add name=”TraceListener” type=”System.Diagnostics.TextWriterTraceListener,System”
   initializeData=”TraceListener.log”/>
 </listeners>
</trace>

<!-- 会话状态设置
默认情况下，ASP.NET 使用 Cookie 来标识哪些请求属于特定的会话。
如果 Cookie 不可用，则可以通过将会话标识符添加到 URL 来跟踪会话。
若要禁用 Cookie，请设置 sessionState cookieless="true"。
-->

默认状态下，ASP.NET通过发送用户cookies（当用户关闭他们的浏览器时，cookies将终止），对会话状态进行维护。

<sessionState mode="InProc" 指ASP.NET会话状态的维护工作是在本地进行的。
stateConnectionString="tcpip=127.0.0.1:42424"
sqlConnectionString="data source=127.0.0.1;Trusted_Connection=yes" cookieless="false" timeout="20"
/>

<!-- 全球化
此节设置应用程序的全球化设置。
-->

Web站点的用户经常要发送和接收文本，这是文本编码格式的配置，默认是rtf-8。

<globalization requestEncoding="GB2312" responseEncoding="GB2312" />
</system.web>

AppSettings元素

<appSettings>元素处于<system.web>根配置之外，它是<configuration>部分的一个子元素。
通过简单的指定一对名称/值，就可以添加配置设置。如：

 <appSettings>
  <add key="websitename" value="My New WebSite"/>
  <add key="welcomemessage" value="Welcome to my new Website,friend!"/>
 </appSettings>
</configuration>