Método ConfigurationSection.SetAllowDefinition

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

Sintaxe

ConfigurationSection.SetAllowDefinition(AllowDefinition)  

ConfigurationSection.SetAllowDefinition(AllowDefinition);  

Parâmetros

Nome	Definição
AllowDefinition	Uma variável string que especifica o valor para o qual o atributo allowDefinition será definido. 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 SetAllowDefinition é 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.SetAllowDefinition "MachineOnly"  

A sintaxe a seguir falha porque tenta chamar SetAllowDefinition 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.SetAllowDefinition "MachineOnly"  

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 define 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")  
  
' Set the AllowDefinition attribute.  
oAnonAuth.SetAllowDefinition "MachineToApplication"  
  

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
Método ConfigurationSection.GetAllowDefinition