<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>