节元素所继承的常规属性
更新：2007 年 11 月
ASP.NET 以分层的方式将配置设置应用于资源。配置设置是从父配置文件继承的。本主题列出由所有节元素继承的数个常规属性。
节元素
节元素是配置节的成员。这不包括配置节组的成员元素。
配置节声明出现在配置文件顶部的 configSections 元素内。section 元素中包含的每个声明都指定一个节的名称，以及用来处理该节中的配置数据的 .NET Framework 类（从 ConfigurationSection 派生）的名称。section 标记可以组合到 sectionGroup 标记中。
有关更多信息，请参见 ASP.NET 配置文件或编辑 ASP.NET 配置文件。
常规属性
下表描述可以为任何节元素设置的常规属性。这些常规属性也由节元素的子元素继承。名称中包含单词 lock 的所有属性都设计用于保护配置文件中的指定内容不被更改。默认情况下不锁定任何元素或属性。
属性 |
说明 |
|---|---|
configSource |
可选的 String 属性。 指定定义关联配置节的包含文件的名称（如果存在这样的文件）。可通过 ConfigSource 属性以编程方式访问。 当使用 configSource 属性时，由于没有元素设置的合并，因此您必须将整个节移动到单独文件。默认情况下，对外部文件所做的任何更改都会导致应用程序重新启动。若要更改此行为，以便应用程序在每次更改之后不会重新启动，您可以在 Web.config 文件中配置 configSections 的 section 元素（常规设置架构）并将其 restartOnExternalChanges 属性设置为 false。 |
lockAllAttributesExcept |
可选的 String 属性；该值可以是逗号分隔的列表。 锁定父元素的所有属性（指定属性除外）。 可通过 LockAllAttributesExcept 属性以编程方式访问。 配置层次结构的较低级别永远不能锁定层次结构中位于它们之上的级别。 |
lockAllElementsExcept |
可选的 String 属性；该值可以是逗号分隔的列表。 锁定父元素的所有子元素（指定子元素除外）。 可通过 LockAllElementsExcept 属性以编程方式访问。 |
lockAttributes |
可选的 String 属性；该值可以是逗号分隔的列表。 锁定父元素的所有属性。 可通过 LockAttributes 属性以编程方式访问。 |
lockElements |
可选的 String 属性；该值可以是逗号分隔的列表。 锁定父元素的所有子元素。 可通过 LockElements 属性以编程方式访问。 |
lockItem |
可选的 String 属性。 如果应锁定该属性所在的元素，则为 true；否则为 false。默认值为 false。 该属性除了用来锁定任何单个元素以外，还可用于集合元素，以便在指定的集合中特别锁定它们。该属性也可用来锁定任何整个节。 可通过 LockItem 属性以编程方式访问。 |
示例
下面的代码示例是 Machine.config 文件的一部分。配置节处理程序是为 system.web 节组和 anonymousIdentification 节声明的。在该声明下，声明了 system.Web 和 anonymousIdentification 配置元素。
system.Web 配置元素是配置节组的成员，这意味着它不包含任何属性。
anonymousIdentification 配置元素是配置节的成员，因此它继承上表列出的属性。请注意，它的 configSource 属性为它分配了一个外部文件（用于包含元素的内容），并且它的 lockItem 属性设置为 true 以防止对它的内容进行更改。
<configuration>
<configSections>
<!-- Other configuration sections. -->
<sectionGroup name="system.web" ...>
<section name="anonymousIdentification" ... />
</sectionGroup>
</configSections>
<system.web>
<anonymousIdentification configSource="IDSourceFile.xml"
lockItem="true" />
</system.web>
</configuration>