configuration 元素（常规设置架构）
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
<configuration xmlns="schema URL">
<!-- configuration settings -->
</configuration>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
|---|---|
xmlns |
可选的 String 特性。 指定用于验证配置文件的 XML 架构的 URL。 如果未设置此特性，则无法在 Microsoft Visual Studio 中使用 F1 帮助打开配置元素的主题。 ASP.NET 2.0 版的默认值为 "https://schemas.microsoft.com/.NetConfiguration/v2.0"。 |
子元素
元素 |
说明 |
|---|---|
configSections |
指定配置节和命名空间声明。 |
appSettings |
包含自定义应用程序设置，如文件路径、XML Web services URL 或存储在应用程序的 .ini 文件中的任何信息。 |
connectionStrings |
为 ASP.NET 应用程序和功能指定数据库连接字符串（名称/值对的形式）的集合。 |
location |
指定应用子配置设置的资源。 此元素也锁定配置设置，以防止子配置文件重写这些设置。 |
指定 ASP.NET 配置架构中的所有元素。 |
|
指定启动设置架构中的所有元素。 |
|
指定运行时设置架构中的所有元素。 |
|
指定远程处理设置架构中的所有元素。 |
|
指定网络设置架构中的所有元素。 |
|
指定密码设置架构中的所有元素。 |
|
指定配置节设置架构中的所有元素。 |
|
指定跟踪和调试设置架构中的所有元素。 |
|
指定 Web services 设置架构中的所有元素。 |
父元素
无。
备注
configuration 元素是公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
每个配置文件必须恰好包含一个 configuration 元素。
默认配置
下面的代码示例演示一个可以为任意 ASP.NET 应用程序创建的基本 Web.config 文件。 customErrors 节在需要的时候提供，但被注释掉。
<?xml version="1.0"?>
<configuration
xmlns="https://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>
元素信息
配置节处理程序 |
不适用。 |
配置成员 |
|
可配置的位置 |
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 |
请参见
任务
Accessing ASP.NET Configuration Settings
参考
connectionStrings 元素（ASP.NET 设置架构）
概念
ASP.NET Configuration Overview
Format of ASP.NET Configuration Files