Compartilhar via

Método ConfigurationSection.GetAllowDefinition

  • Artigo

Recupera o atributo allowDefinition para uma seção de configuração.

Sintaxe

ConfigurationSection.GetAllowDefinition AllowDefinition  

ConfigurationSection.GetAllowDefinition(AllowDefinition);

Parâmetros

Nome Definição
AllowDefinition Uma variável string que recebe o atributo allowDefinition que o método GetAllowDefinition retorna. Os possíveis valores de atributos estão listados posteriormente na seção Comentários.

Valor de retorno

Esse método não retorna um valor.

Comentários

allowDefinition os atributos especificam onde na hierarquia de configuração os valores podem ser definidos para uma determinada seção de configuração. Esses atributos são especificados na seção <configSections> do arquivo ApplicationHost.config.

Como GetAllowDefinition é um método estático, será necessário chamá-lo obtendo um objeto de classe, conforme o exemplo a seguir.

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition

A sintaxe a seguir falha porque tenta chamar GetAllowDefinition em uma instância concreta da classe Site. A chamada para o método causará um erro "SWbemObjectEx: não encontrado".

' Incorrect syntax:  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition

A tabela a seguir lista os valores possíveis para o atributo allowDefinition.

Palavra-chave Descrição
Everywhere É possível definir a seção em qualquer lugar da hierarquia.
MachineOnly A seção pode ser definida somente no arquivo Machine.config. Anotação: o local padrão para o arquivo Machine.config é %systemroot% Microsoft.NET\Framework\<versão>\config\.
MachineToWebRoot A seção pode ser definida somente no arquivo Machine.config ou no arquivo Web.config raiz. Anotação:o local padrão para o arquivo Web.config raiz é %systemroot% Microsoft.NET\Framework\<versão>\config\.
AppHostOnly A seção pode ser definida somente no arquivo ApplicationHost.config.
MachineToApplication A seção pode ser definida somente no nível global. Para seções do .NET Framework, o nível global é o arquivo raiz Web.config ou Machine.config; para seções do IIS, é o arquivo ApplicationHost.config; e, para aplicativos, é o arquivo Web.config do aplicativo raiz.

Exemplo

O exemplo a seguir exibe o atributo allowDefinition para a seção Configuração de autenticação anônima.

' Get the WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the AnonymousAuthenticationSection.  
Set oAnonAuth = oWebAdmin.Get( _  
    "AnonymousAuthenticationSection")  
  
' Get the allowDefinition attribute.  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition  
  
' Display the allowDefinition attribute.  
WScript.Echo _  
    "Anonymous Authentication Allow Definition: " & _  
        strAnonAuthAllowDefinition

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 AnonymousAuthenticationSection
Classe ConfigurationSection