Класс SectionInformation

Статья
07/10/2024

Задает параметры переопределения и блокировки управления для раздела конфигурации.

Синтаксис

class SectionInformation : EmbeddedObject

Методы

Этот класс не содержит методов.

Свойства

В следующей таблице перечислены свойства, предоставляемые классом SectionInformation .

Имя	Описание
`EffectiveOverrideMode`	Значение только для `string` чтения, указывающее, может ли текущий раздел конфигурации эффективно переопределить унаследованные параметры. Возможные значения перечислены далее в разделе "Примечания". Чтобы определить значение `EffectiveOverrideMode`, IIS проходит по иерархии наследования разделов конфигурации из текущего раздела. Он последовательно проверяет `OverrideMode` свойство каждого родительского раздела, пока не достигнет атрибута `overrideModeDefault` в определении схемы раздела. IIS вычисляет `EffectiveOverrideMode` путем логического объединения значений, с которыми он сталкивается, и учитывая их иерархическое ранжирование. Примечание. `overrideModeDefault` Это необязательный атрибут, содержащий состояние блокировки по умолчанию раздела конфигурации. Атрибут `overrideModeDefault` для каждого раздела конфигурации находится в соответствующем определении `<configSections>` раздела в файле ApplicationHost.config. Если `overrideModeDefault` отсутствует, его значение равно "Разрешить". Если указан параметр Allow, файлы web.config более низкого уровня могут переопределить параметры для раздела; Значение "Запретить", если указано значение "Запрет", они не могут. Значение `overrideModeDefault` по умолчанию для большинства разделов веб-сервера IIS — "Запретить". По умолчанию для большинства разделов ASP.NET и платформа .NET Framework используется значение Allow, так как эти разделы содержат параметры уровня приложения. Атрибут `overrideModeDefault` не имеет соответствующего свойства в WMI. Если у вас есть соответствующие разрешения, можно изменить файл конфигурации ApplicationHost.config напрямую или получить к нему доступ программным образом с помощью API-интерфейсов анализа XML или доступа к файлам.
`IsLocked`	Значение `boolean`, доступное только для чтения. `true` Значение , если текущий раздел конфигурации и его дочерние элементы не могут быть изменены; `false`в противном случае .
`LockItem`	Значение чтения и записи `boolean` . `true` Значение , если текущий раздел конфигурации и его дочерние элементы заблокированы; `false`в противном случае . Значение по умолчанию — `false`. Примечание. Хотя используется `false`значение по умолчанию, это свойство возвращается `null` при первоначальном чтении. Если вы явно задали это начальное значение `false`, свойство по-прежнему возвращается `null`. Однако если задано начальное значение `true`, свойство возвращается `true`; если вы задали значение `false`, свойство будет явным образом возвращать `false`. Это поведение обусловлено ограничением в поставщике WMI.
`OverrideMode`	Значение чтения и записи `string` , указывающее, могут ли файлы конфигурации нижнего уровня переопределить параметры в текущем разделе конфигурации. Возможные значения перечислены далее в разделе "Примечания".

Подклассы

Этот класс не содержит подклассов.

Замечания

Экземпляры этого класса содержатся в SectionInformation свойстве класса ConfigurationSection . Все классы разделов конфигурации наследуют SectionInformation класс в качестве одного из своих свойств.

В следующей EffectiveOverrideMode таблице перечислены возможные значения свойства.

Ключевое слово	Description
`Allow`	Файлы конфигурации нижнего уровня могут переопределить параметры в текущем разделе конфигурации.
`Deny`	Файлы конфигурации нижнего уровня не могут переопределить параметры в текущем разделе конфигурации.

В следующей OverrideMode таблице перечислены возможные значения свойства. Значение по умолчанию — "Наследовать".

Ключевое слово	Description
`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

Требования

Тип	Описание
Клиент	— 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

См. также

Класс ConfigurationSection
Класс EmbeddedObject

Поделиться через