节元素所继承的常规特性

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

ASP.NET 以分层的方式将配置设置应用于资源。配置设置是从父配置文件继承的。本主题列出由所有节元素继承的数个常规特性。

节元素

节元素是配置节的成员。这不包括配置节组的成员元素。

配置节声明出现在配置文件顶部的 configSections 元素内。 section 元素中包含的每个声明都指定一个节的名称，以及用来处理该节中的配置数据的 .NET Framework 类（从 ConfigurationSection 派生）的名称。 section 标记可以组合到 sectionGroup 标记中。

有关更多信息，请参见ASP.NET Configuration Files 或Format of ASP.NET Configuration Files。

常规特性

下表描述可以为任何节元素设置的常规特性。这些常规特性也由节元素的子元素继承。名称中包含单词 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>

请参见

节元素所继承的常规特性

节元素

常规特性

示例

请参见

任务

概念

其他资源

其他资源