通过

<section> 元素

包含配置节声明。

<配置>
   <configSections>
     <部分>

<配置>
   <configSections>
     <sectionGroup>
       <部分>

Syntax

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

必需属性

Description
name 指定配置节的名称。
type 指定从配置文件中读取节的配置节处理程序类的名称。 类型值具有语法“fully-qualified-section-handler-class-name， simple-assembly-name”。 简单程序集名称是没有 .dll 文件扩展名的根文件名。

可选属性

以下属性仅适用于 ASP.NET 应用程序。 配置系统忽略其他应用程序类型的这些属性。

Description
allowDefinition 指定节可以使用的配置文件。 使用下列值之一：

到处
允许在任何配置文件中使用节。 这是默认情况。
MachineOnly
仅允许在计算机配置文件（Machine.config）中使用节。
MachineToApplication
允许在计算机配置文件或应用程序配置文件中使用节。
allowLocation 确定该节是否可以在 <location> 元素中使用。 使用下列值之一：

true
允许在 <location> 元素中使用节。 这是默认情况。
假
不允许在 <location> 元素中使用节。

父元素

Description
<configSections> 元素 包含配置节和命名空间声明。
<sectionGroup> 元素 定义配置节的命名空间。

注释

元素 <section> 是任 <configSections> 一元素 <sectionGroup> 的子元素，但不是两者。

子元素

None

注解

声明配置节实质上定义配置文件的新元素。 新元素包含配置节处理程序（即实现接口的 IConfigurationSectionHandler 类）读取的设置。 定义的节的属性和子元素取决于用于读取设置的节处理程序。

通过 声明Machine.config 文件中的配置节处理程序，可以在该计算机上的任何应用程序配置文件中使用配置节，除非该 allowDefinition 属性另有说明。

Example

以下示例演示如何定义配置节并定义该部分的设置：

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

配置文件

此元素可用于应用程序配置文件、计算机配置文件（Machine.config）和不在应用程序目录级别的 Web.config 文件。

另请参阅

  • Last updated on