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