SectionInformation 类
指定配置节的替代模式和控制锁定设置。
语法
class SectionInformation : EmbeddedObject
方法
此类不包含任何方法。
属性
下表列出了 SectionInformation 类公开的属性。
| 名称 | 描述 |
|---|---|
EffectiveOverrideMode |
一个只读的 string 值，指定当前配置节是否可以有效重写其继承的设置。 后文的“备注”部分列出了可能的值。为了确定 EffectiveOverrideMode 的值，IIS 从当前部分开始向上遍历配置部分的继承层次结构。 它连续检查每个父部分的 OverrideMode 属性，直到到达部分架构定义中的 overrideModeDefault 属性。 IIS 通过逻辑组合遇到的值并考虑它们的层次排名来计算 EffectiveOverrideMode。 注意： overrideModeDefault 是一个可选属性，其中包含配置节的默认锁定状态。 每个配置部分的 overrideModeDefault 属性位于 ApplicationHost.config 文件中 <configSections> 下的相应部分定义中。 如果缺少 overrideModeDefault，则其值为“Allow”。 如果指定“Allow”，则较低级别的 Web.config 文件可以重写该部分的设置；如果指定“Deny”，则不能重写。 大多数 IIS Web 服务器部分的 overrideModeDefault 默认值为“Deny”。 大多数 ASP.NET 和 .NET Framework 部分的默认设置为“Allow”，因为这些部分包含应用程序级设置。 overrideModeDefault 属性在 WMI 中没有相应的属性。 如果你有适当的权限，则可以直接编辑 ApplicationHost.config 文件，或使用 XML 分析或文件访问 API 以编程方式访问它。 |
IsLocked |
只读的 boolean 值。 如果当前配置部分及其子元素无法修改，则为 true；否则为 false。 |
LockItem |
一个读/写 boolean 值。 如果当前配置部分及其子元素已锁定，则为 true；否则为 false。 默认为 false。 注意：虽然默认值为 false，但该属性在最初读取时将返回 null。 如果显式将此初始值设置为 false，该属性仍将返回 null。 但是，如果将初始值设置为 true，则该属性将返回 true；如果随后将该值设置为 false，该属性将显式返回 false。 此行为是由于 WMI 提供程序的限制造成的。 |
OverrideMode |
一个读/写 string 值，指定较低级别的配置文件是否可以重写当前配置部分中的设置。 后文的“备注”部分列出了可能的值。 |
子类
此类不包含子类。
注解
此类的实例包含在 ConfigurationSection 类的 SectionInformation 属性中。 所有配置部分类都继承 SectionInformation 类作为其属性之一。
下表列出了 EffectiveOverrideMode 属性的可能值。
| 关键字 | 说明 |
|---|---|
Allow |
较低级别的配置文件可以重写当前配置部分中的设置。 |
Deny |
较低级别的配置文件无法重写当前配置部分中的设置。 |
下表列出了 OverrideMode 属性的可能值。 默认值为“Inherit”。
| 关键字 | 说明 |
|---|---|
Inherit |
较低级别的配置文件可以或不可以重写当前配置部分中的设置，具体取决于它们继承的 OverrideMode 值的组合。 |
Allow |
较低级别的配置文件可以重写当前配置部分中的设置。 |
Deny |
较低级别的配置文件无法重写当前配置部分中的设置。 |
注意
当 OverrideMode 属性设置为“Inherit”时，EffectiveOverrideMode 属性可用于确定配置部分的有效重写模式。
示例
以下示例检索所有配置部分的 SectionInformation 属性。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve configuration sections.
Set oConfigSections = oWebAdmin.ExecQuery( _
"SELECT * FROM ConfigurationSection")
' Loop through the configuration sections.
For Each oConfigSection In oConfigSections
iCounter = iCounter + 1
' Display the name of each configuration section and its location.
WScript.Echo "[" & iCounter & "] " & oConfigSection.Path_.Class
WScript.Echo "Location: " & oConfigSection.Location
' Display the SectionInformation property values.
Set oConfigSectionInfo = oConfigSection.SectionInformation
WScript.Echo "Effective Override Mode: " & _
oConfigSectionInfo.EffectiveOverrideMode
WScript.Echo "Is Locked: " & oConfigSectionInfo.IsLocked
WScript.Echo "Is Present: " & oConfigSectionInfo.IsPresent
WScript.Echo "Lock Item: " & oConfigSectionInfo.LockItem
WScript.Echo "Override Mode: " & oConfigSectionInfo.OverrideMode
WScript.Echo "------------------------------------------"
Next
继承层次结构
SectionInformation
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |