指定配置文件中 ASP.NET 配置设置的根元素,并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。
configuration
元素(常规设置架构)
system.web
元素(ASP.NET 设置架构)
<system.web>
<anonymousIdentification>
<authentication>
<authorization>
<browserCaps>
<caching>
<clientTarget>
<compilation>
<customErrors>
<deployment>
<deviceFilters>
<globalization>
<healthMonitoring>
<hostingEnvironment>
<httpCookies>
<httpHandlers>
<httpModules>
<httpRuntime>
<identity>
<machineKey>
<membership>
<mobileControls>
<pages>
<processModel>
<profile>
<roleManager>
<securityPolicy>
<sessionPageState>
<sessionState>
<siteMap>
<trace>
<trust>
<urlMappings>
<webControls>
<webParts>
<webServices>
<xhtmlConformance>
</system.web>
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
无。
子元素
元素 | 说明 |
---|---|
anonymousIdentification 元素(ASP.NET 设置架构) | 针对应用程序授权配置匿名标识。这是在需要授权时,对没有经过身份验证的实体进行标识所必需的。 |
authentication 元素(ASP.NET 设置架构) | 配置 ASP.NET 身份验证支持。 |
authorization 元素(ASP.NET 设置架构) | 配置 ASP.NET 授权支持。 |
browserCaps 元素(ASP.NET 设置架构) | 配置浏览器功能组件的设置。 |
caching 元素(ASP.NET 设置架构) | 为 Web 应用程序配置缓存设置。 |
clientTarget 元素(ASP.NET 设置架构) | 将特定用户代理的别名添加到用户代理别名的内部集合中。 |
compilation 元素(ASP.NET 设置架构) | 包含 ASP.NET 使用的所有编译设置。 |
customErrors 元素(ASP.NET 设置架构) | 为 ASP.NET 应用程序定义自定义错误消息。 |
deployment 元素(ASP.NET 设置架构) | 定义用于支持 Web 应用程序部署的配置设置。 |
deviceFilters 元素(ASP.NET 设置架构) | 根据用户代理或浏览器指定 ASP.NET MobileCapabilities 类中的设备或设备类。页或应用程序开发人员可以使用设备筛选器来重写控件属性或者定义内容块或模板块以更改布局和外观。 |
globalization 元素(ASP.NET 设置架构) | 配置应用程序的全球化设置。 |
healthMonitoring 元素(ASP.NET 设置架构) | 针对运行状况监视配置应用程序。 |
hostingEnvironment 元素(ASP.NET 设置架构) | 定义用来控制应用程序宿主环境的行为的配置设置。 |
httpCookies 元素(ASP.NET 设置架构) | 为 Web 应用程序使用的 Cookie 配置属性。 |
httpHandlers 元素(ASP.NET 设置架构) | 将传入的 URL 请求映射到 IHttpHandler 类。 |
httpModules 元素(ASP.NET 设置架构) | 添加、移除或清除应用程序中的 HTTP 模块。 |
httpRuntime 元素(ASP.NET 设置架构) | 配置 ASP.NET HTTP 运行时设置。 |
该节可以在计算机、站点、应用程序或子目录级别声明。 | |
identity 元素(ASP.NET 设置架构) | 控制 Web 应用程序的应用程序标识。 |
machineKey 元素(ASP.NET 设置架构) | 配置用于加密和解密 Forms 身份验证 Cookie 数据的密钥。 |
该节使您能够配置验证密钥,而验证密钥可以对视图状态数据和 Forms 身份验证票证执行消息身份验证检查。 | |
该节可在计算机、站点或应用程序级别声明,但不在子目录级别声明。 | |
membership 元素(ASP.NET 设置架构) | 为 ASP.NET 成员资格配置用于对用户帐户进行管理和身份验证的参数。 |
mobileControls 元素(ASP.NET 设置架构) | 定义适配器集,以将 ASP.NET 移动控件映射到 Web.config 文件的 system.web 节中的相应适配器。 |
pages 元素(ASP.NET 设置架构) | 标识特定于页的配置设置。 |
processModel 元素(ASP.NET 设置架构) | 配置 Internet 信息服务 (IIS) Web 服务器系统上的 ASP.NET 进程模型设置。 |
profile 元素(ASP.NET 设置架构) | 使用 ASP.NET 配置文件来配置用于管理用户值的参数。 |
roleManager 元素(ASP.NET 设置架构) | 为角色管理配置应用程序。 |
此元素是 .NET Framework 2.0 版中的新元素。 | |
securityPolicy 元素(ASP.NET 设置架构) | 定义命名安全级别与策略文件的有效映射。 |
该节可以在计算机、站点或应用程序级别声明。 | |
sessionPageState 元素(ASP.NET 设置架构) | 为 ASP.NET 应用程序配置页的视图状态设置。 |
sessionState 元素(ASP.NET 设置架构) | 配置会话状态模块。 |
siteMap 元素(ASP.NET 设置架构) | 配置导航基础结构支持以配置、存储和呈现站点导航。 |
trace 元素(ASP.NET 设置架构) | 配置 ASP.NET 跟踪服务。 |
trust 元素(ASP.NET 设置架构) | 配置用于运行特定应用程序的代码访问安全权限集。 |
该节可以在计算机、站点和应用程序级别声明。 | |
urlMappings 元素(ASP.NET 设置架构) | 定义一个映射,该映射隐藏实际的 URL 并将其映射到用户更容易记忆的 URL。 |
webControls 元素(ASP.NET 设置架构) | 指定客户端脚本文件的共享位置。 |
webParts | 指定 Web 部件个性化设置提供程序、设置个性化设置授权以及添加自定义类(用于扩展 WebPartTransformer 类供 Web 部件连接使用)。 |
webServices 元素(ASP.NET 设置架构) | 控制使用 ASP.NET 创建的 XML Web services 的设置。 |
xhtmlConformance 元素(ASP.NET 设置架构) | 配置符合 XHTML 1.0 的控件呈现。 |
父元素
元素 | 说明 |
---|---|
configuration | 指定公共语言运行库和 .NET Framework 应用程序使用的每个配置文件中的根元素。 |
configuration
元素(常规设置架构)
公共语言运行库和 .NET Framework
应用程序所使用的每个配置文件中均需要的根元素。
<configuration xmlns="schema URL">
<!-- configuration settings -->
</configuration>
属性和元素
属性
属性 | 说明 |
---|---|
xmlns | 可选的 String 属性。 |
指定用于验证配置文件的 XML 架构的 URL。如果未设置此属性,则无法在 Microsoft Visual Studio 中使用 F1 帮助打开配置元素的主题。 | |
ASP.NET 2.0 版的默认值为 “http://schemas.microsoft.com/.NetConfiguration/v2.0”。 |
子元素
元素 | 说明 |
---|---|
configSections | 指定配置节和命名空间声明。 |
appSettings | 包含自定义应用程序设置,如文件路径、XML Web services URL 或存储在应用程序的 .ini 文件中的任何信息。 |
connectionStrings | 为 ASP.NET 应用程序和功能指定数据库连接字符串(名称/值对的形式)的集合。 |
location | 指定应用子配置设置的资源。此元素也锁定配置设置,以防止子配置文件重写这些设置。 |
ASP.NET 设置架构 | 指定 ASP.NET 配置架构中的所有元素。 |
启动设置架构 | 指定启动设置架构中的所有元素。 |
运行库设置架构 | 指定运行库设置架构中的所有元素。 |
远程处理设置架构 | 指定远程处理设置架构中的所有元素。 |
网络设置架构 | 指定网络设置架构中的所有元素。 |
密码设置架构 | 指定密码设置架构中的所有元素。 |
配置节架构 | 指定配置节设置架构中的所有元素。 |
跟踪和调试设置架构 | 指定跟踪和调试设置架构中的所有元素。 |
XML Web Services 设置架构 | 指定 Web services 设置架构中的所有元素。 |
父元素
无。
备注
configuration
元素是公共语言运行库和 .NET Framework
应用程序所使用的每个配置文件中均需要的根元素。
每个配置文件必须恰好包含一个 configuration
元素。
默认配置
下面的代码示例演示一个可以为任意 ASP.NET
应用程序创建的基本 Web.config
文件。customErrors
节在需要的时候提供,但被注释掉。
<?xml version="1.0"?>
<configuration
xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
<appSettings/>
<connectionStrings/>
<system.web>
<compilation debug="false"/>
<authentication mode="Windows"/>
<!--
<customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
<error statusCode="403" redirect="NoAccess.htm"/>
<error statusCode="404" redirect="FileNotFound.htm"/>
</customErrors>
-->
</system.web>
</configuration>
元素信息
项 | 说明 |
---|---|
配置节处理程序 | 不适用。 |
配置成员 | Configuration |
可配置的位置 | Machine.config |
根级别的 Web.config | |
应用程序级别的 Web.config | |
虚拟或物理目录级别的 Web.config | |
要求 | Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 |
.NET Framework 版本 1.0、1.1 或 2.0 | |
Microsoft Visual Studio 2003 或 Visual Studio 2005 |