Web.config详解

< DOCTYPE html PUBLIC -WCDTD XHTML StrictEN httpwwwworgTRxhtmlDTDxhtml-strictdtd>

<?xml version="1.0" encoding="utf-8" ?>

<configuration> 所有.NET配置文件所必须的根元素



<system.web> 实际ASP.NET配置设置的根元素



<!-- 动态调试编译

设置 compilation debug="true" 以启用 ASPX 调试。否则，将此值设置为

false 将提高此应用程序的运行时性能。

设置 compilation debug="true" 以将调试符号(.pdb 信息)插入到编译页中。

因为这将创建执行起来较慢的大文件，所以应该只在调试时将此值设置为 true，而在所有其他时候都设置为false。有关更多信息，请参考有关调试 ASP.NET 文件的文档。

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>

#c#专栏