共用方式為

SectionInformation 類別

指定組態區段的覆寫模式和控制鎖定設定。

語法

class SectionInformation : EmbeddedObject

方法

這個類別不包含任何方法。

屬性

下表列出 類別所 SectionInformation 公開的屬性。

名稱 描述
EffectiveOverrideMode 唯讀 string 值，指定目前的組態區段是否可以有效地覆寫其繼承的設定。 可能的值稍後會列在一節中。

若要判斷的值 EffectiveOverrideMode，IIS 會從目前區段周遊組態區段的繼承階層。 它會連續檢查 OverrideMode 每個父區段的 屬性，直到到達 overrideModeDefault 區段架構定義中的 屬性為止。 IIS 會 EffectiveOverrideMode 以邏輯方式結合所遇到的值，並考慮其階層式排名來計算 。 注意： overrideModeDefault 是選擇性屬性，其中包含組態區段的默認鎖定狀態。 overrideModeDefault每個組態區段的屬性都位於 ApplicationHost.config 檔案底下的<configSections>對應區段定義中。 如果 overrideModeDefault 遺失，其值為 「Allow」。。 如果指定了 「允許」，較低層級的Web.config檔案可以覆寫區段的設定;如果指定了 「拒絕」，則無法。 overrideModeDefault大部分 IIS 網頁伺服器區段的預設值為 「拒絕」。 大部分 ASP.NET 和 .NET Framework 區段的預設值為 「允許」，因為這些區段包含應用層級設定。 屬性 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 值，指定較低層級的組態檔是否可以覆寫目前組態區段中的設定。 可能的值稍後會列在一節中。

子類別

這個類別不包含子類別。

備註

這個類別的實例包含在 SectionInformation ConfigurationSection 類別的 屬性中。 所有組態區段類別都會繼承類別 SectionInformation 做為其其中一個屬性。

下表列出 屬性的 EffectiveOverrideMode 可能值。

關鍵字 描述
Allow 較低層級的組態檔可以覆寫目前組態區段中的設定。
Deny 較低層級的組態檔無法覆寫目前組態區段中的設定。

下表列出 屬性的 OverrideMode 可能值。 預設值為 「繼承」。

關鍵字 描述
Inherit 較低層級的組態檔可以或無法覆寫目前組態區段中的設定，視它們繼承的值組合 OverrideMode 而定。
Allow 較低層級的組態檔可以覆寫目前組態區段中的設定。
Deny 較低層級的組態檔無法覆寫目前組態區段中的設定。

注意

屬性 EffectiveOverrideMode 在判斷組態區段的有效覆寫模式設定為 「繼承」時 OverrideMode 很有用。

範例

下列範例會 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

繼承階層架構

EmbeddedObject

SectionInformation

需求

類型 描述
用戶端 - Windows Vista 上的 IIS 7.0
- Windows 7 上的 IIS 7.5
- Windows 8 上的 IIS 8.0
- Windows 10 上的 IIS 10.0
伺服器 - Windows Server 2008 上的 IIS 7.0
- Windows Server 2008 R2 上的 IIS 7.5
- Windows Server 2012 上的 IIS 8.0
- Windows Server 2012 R2 上的 IIS 8.5
- Windows Server 2016 上的 IIS 10.0
Products - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 檔案 WebAdministration.mof

另請參閱

ConfigurationSection 類別
EmbeddedObject 類別

  • Last updated on