
<section name="section name" type="configuration section handler class, assembly file name, version, culture, public key token" allowDefinition= "Everywhere\|MachineOnly\|MachineToApplication\|MachineToWebRoot" allowLocation="True\|False" restartOnExternalChanges="True\|False" />

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

下面几部分描述了属性、子元素和父元素。

属性

属性说明

allowDefinition

可选的 Boolean 属性。

仅适用于 ASP.NET 应用程序。

指定可以在哪个配置文件中使用该节。

此属性可以是下列值（在 ConfigurationAllowDefinition 枚举中定义）之一，这些值按照适用范围不断缩小的顺序排列。

值	说明
Everywhere	允许在任何配置文件或目录中配置该节，如下所示： Machine.config。根 Web.config。应用程序的 Web.config。虚拟目录。应用程序中的物理子目录。如果未使用 allowDefinition 属性，则假设为 Everywhere。这是默认设置。
MachineToApplication	允许在下列文件之一中配置该节： Machine.config。根 Web.config。应用程序的 Web.config。这不包括位于应用程序中的虚拟目录或物理子目录下的 Web.config 文件。
MachineToWebRoot	允许在下列文件之一中配置该节： Machine.config。根 Web.config。 Machine.config 和根 Web.config 文件都位于 %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG 中。
MachineOnly	只允许在 Machine.config 文件中配置该节，该文件位于 %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG 中。

allowExeDefinition

可选的 Boolean 属性。

仅适用于 .NET Framework 客户端应用程序。

指定可以在哪个配置文件中使用该节。

此属性可以是下列值（在 ConfigurationAllowExeDefinition 枚举中定义）之一，这些值按照适用范围不断缩小的顺序排列。

值	说明
MachineToApplication	允许在下列文件之一中配置该节： Machine.config。应用程序配置。
MachineToRoamingUser
MachineToLocalUser
MachineOnly	只允许在 Machine.config 文件中配置该节，该文件位于 %SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG 中。

allowLocation

可选的 Boolean 属性。

仅适用于 ASP.NET 应用程序。

指定是否可以在 location 元素内使用该节。

默认值为 True。

name

必选的 String 属性。

指定与 type 属性中指定的配置节处理程序关联的配置节或元素的名称。这是该元素在配置文件的节设置区域中使用的名称。

restartOnExternalChanges

可选的 Boolean 属性。

不适用于 ASP.NET 应用程序。

指定在该节的配置数据发生更改时是否应当重新启动应用程序。

type

必选的 String 属性。

指定用来执行如下操作的配置节处理程序类的名称：处理在 name 属性中指定的节或元素中的配置设置。使用以下格式：

type=" Fully qualified class name , assembly file name , version , culture , public key token "

定义必须匹配程序集引用。例如，如果下面的示例语法中的版本号与程序集不匹配，则会发生错误。

?	复制代码
type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

程序集文件必须与定义它的 Web.config 文件位于同一个应用程序目录中。对于根 Web.config 文件或 Machine.config 文件，程序集文件必须在 %SystemRoot%\Microsoft.NET\Framework\version 中。

子元素

无。

父元素

元素	说明
configuration	指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
configSections	指定配置节和命名空间声明。
sectionGroup	定义配置节处理程序与配置节之间的关联。

section 元素将配置节处理程序与配置元素或节关联。由于 ASP.NET 不对如何处理配置文件内的设置作任何假设，因此这非常必要。但 ASP.NET 会将配置数据的处理委托给配置节处理程序。每个 section 元素均标识一个配置节或元素，以及从处理配置节或元素的 ConfigurationSection 派生的关联类。可以在 sectionGroup 元素中对 section 元素进行逻辑分组以便进行组织，并帮助避免命名冲突。section 和 sectionGroup 元素包含在 configSections 元素中。

默认配置

?	复制代码
<configuration> <configSections> <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%"> <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" /> <!-- Other system.web sections --> </sectionGroup> <!-- Other configuration sections --> </configSections> <system.web> <authentication mode="Windows"> <forms name=".ASPXAUTH" loginUrl="login.aspx" defaultUrl="default.aspx" protection="All" timeout="30" path="/" requireSSL="False" slidingExpiration="True" cookieless="UseCookies" domain="" enableCrossAppRedirects="False"> <credentials passwordFormat="SHA1" /> </forms> <passport redirectUrl="internal" /> </authentication> <!-- Other system.web elements --> </system.web> <!-- Other configuration settings --> </configuration>

下面的代码示例演示如何定义自定义配置节以及如何定义该节的设置。

?	复制代码
<configuration> <configSections> <section name="sampleSection" type="System.Configuration.SingleTagSectionHandler" /> </configSections> <sampleSection setting1="Value1" setting2="value two" setting3="third value" /> </configuration>

?

复制代码

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

配置节处理程序	不适用。
配置成员	ConfigurationSection
可配置的位置	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

参考

configSections 元素（常规设置架构）
configSections 的 sectionGroup 元素（常规设置架构）
configSections 的 clear 元素（常规设置架构）
configSections 的 remove 元素（常规设置架构）
configuration 元素（常规设置架构）

概念

ASP.NET 配置文件层次结构和继承
编辑 ASP.NET 配置文件
ASP.NET 配置方案

其他资源

常规配置设置 (ASP.NET)
ASP.NET 配置设置
ASP.NET 配置文件
配置 ASP.NET 应用程序
ASP.NET 配置 API

属性和元素

属性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

参考

概念

其他资源