configuration 元素(常规设置架构)

更新:2007 年 11 月

公共语言运行库和 .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 设置架构

指定 ASP.NET 配置架构中的所有元素。

启动设置架构

指定启动设置架构中的所有元素。

运行库设置架构

指定运行库设置架构中的所有元素。

远程处理设置架构

指定远程处理设置架构中的所有元素。

网络设置架构

指定网络设置架构中的所有元素。

密码设置架构

指定密码设置架构中的所有元素。

配置节架构

指定配置节设置架构中的所有元素。

跟踪和调试设置架构

指定跟踪和调试设置架构中的所有元素。

XML Web Services 设置架构

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

元素信息

配置节处理程序

不适用。

配置成员

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

请参见

任务

如何:以编程方式访问 ASP.NET 配置设置

概念

ASP.NET 配置概述

保证 ASP.NET 配置的安全

编辑 ASP.NET 配置文件

ASP.NET 配置方案

参考

configSections 元素(常规设置架构)

appSettings 元素(常规设置架构)

connectionStrings 元素(ASP.NET 设置架构)

location 元素(ASP.NET 设置架构)

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

管理 ASP.NET 网站

ASP.NET 配置 API

配置文件