Classe SectionInformation

Especifica as configurações de modo de substituição e o bloqueio de controle para uma seção de configuração.

Sintaxe

class SectionInformation : EmbeddedObject  

Métodos

Essa classe não contém métodos.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe SectionInformation.

Nome	Descrição
EffectiveOverrideMode	Um valor string somente leitura que especifica se a seção de configuração atual pode efetivamente substituir as configurações herdadas. Os valores possíveis estão listados posteriormente na seção Comentários. Para determinar o valor de EffectiveOverrideMode, o IIS percorre a hierarquia de herança das seções de configuração da seção atual. Ele examina sucessivamente a propriedade OverrideMode de cada seção pai até atingir o atributo overrideModeDefault na definição de esquema da seção. O IIS calcula o EffectiveOverrideMode combinando logicamente os valores que encontra e considerando sua classificação hierárquica. Observação: overrideModeDefault é um atributo opcional que contém o estado de bloqueio padrão de uma seção de configuração. O atributo overrideModeDefault para cada seção de configuração está localizado na definição de seção correspondente em <configSections> no arquivo ApplicationHost.config. Se overrideModeDefault estiver faltando, seu valor será "Permitir". Se "Permitir" for especificado, os arquivos Web.config de nível inferior poderão substituir as configurações da seção; se "Negar" for especificado, eles não poderão. O padrão overrideModeDefault para a maioria das seções do servidor Web do IIS é "Negar". O padrão para a maioria das seções ASP.NET e .NET Framework é "Permitir", porque elas contêm configurações no nível do aplicativo. O atributo overrideModeDefault não tem nenhuma propriedade correspondente no WMI. Se você tiver permissões apropriadas, poderá editar o arquivo ApplicationHost.config diretamente ou acessá-lo programaticamente usando APIs de acesso a arquivos ou de análise de XML.
IsLocked	Um valor boolean somente leitura. true se a seção de configuração atual e seus elementos filho não puderem ser modificados; caso contrário, false.
LockItem	Um valor boolean de leitura/gravação. true se a seção de configuração atual e seus elementos filho estiverem bloqueados; caso contrário, false. O padrão é false. Observação: embora o padrão seja false, essa propriedade retornará null quando for lida inicialmente. Se você definir explicitamente esse valor inicial como false, a propriedade ainda retornará null. No entanto, se você definir o valor inicial como true, a propriedade retornará true; se você definir o valor como false, a propriedade retornará false explicitamente. Esse comportamento é devido a uma limitação no provedor WMI.
OverrideMode	Um valor string de leitura/gravação que especifica se os arquivos de configuração de nível inferior podem substituir as configurações na seção atual. Os valores possíveis estão listados posteriormente na seção Comentários.

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias desta classe estão contidas na propriedade de matriz SectionInformation da classe ConfigurationSection. Todas as classes de seção de configuração herdam a classe SectionInformation como uma de suas propriedades.

A tabela a seguir lista os possíveis valores da propriedade EffectiveOverrideMode.

Palavra-chave	Descrição
Allow	Os arquivos de configuração de nível inferior podem substituir as configurações na seção atual.
Deny	Os arquivos de configuração de nível inferior não podem substituir as configurações na seção atual.

A tabela a seguir lista os possíveis valores da propriedade OverrideMode. O padrão é "Herdar".

Palavra-chave	Descrição
Inherit	Os arquivos de configuração de nível inferior podem ou não substituir as configurações na seção de configuração atual, dependendo da combinação de valores OverrideMode que eles herdam.
Allow	Os arquivos de configuração de nível inferior podem substituir as configurações na seção atual.
Deny	Os arquivos de configuração de nível inferior não podem substituir as configurações na seção atual.

Observação

A propriedade EffectiveOverrideMode é útil para determinar qual é o modo de substituição efetivo para uma seção de configuração quando a propriedade OverrideMode é definida como "Herdar".

Exemplo

O exemplo a seguir recupera as propriedades SectionInformation de todas as seções de configuração.

' 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  
  

Hierarquia de herança

EmbeddedObject

SectionInformation

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

Classe ConfigurationSection
Classe EmbeddedObject