<section> 元素

包含配置节声明。

configuration
  <configSections>
    <section>

configuration
  <configSections>
    <sectionGroup>
      <section>

语法

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

必需属性

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

可选属性

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

	说明
allowDefinition	指定可在其中使用节的配置文件。 使用以下值之一： 无处不在 允许该节在任何配置文件中使用。 这是默认值。 MachineOnly 允许该节仅在计算机配置文件中使用 (Machine.config)。 MachineToApplication 允许该节在计算机配置文件或应用程序配置文件中使用。
allowLocation	确定是否可以在 <location> 元素内使用该节。 使用以下值之一： true 允许该节在 <location> 元素内使用。 这是默认值。 false 不允许该节在 <location> 元素内使用。

父元素

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

注意

<section> 元素是 <configSections> 或 <sectionGroup> 的子元素，但不能同时为两者。

子元素

无

备注

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

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

示例

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

<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 文件。

请参阅

• .NET Framework 的配置文件架构