Condividi tramite


Metodo ConfigurationSection.SetAllowDefinition

Imposta l'attributo allowDefinition per una sezione di configurazione.

Sintassi

ConfigurationSection.SetAllowDefinition(AllowDefinition)  
ConfigurationSection.SetAllowDefinition(AllowDefinition);  

Parametri

Nome Definizione
AllowDefinition Variabile string che specifica il valore a cui verrà impostato l'attributo allowDefinition . I valori possibili degli attributi sono elencati più avanti nella sezione Osservazioni.

Valore restituito

Questo metodo non restituisce valori.

Commenti

allowDefinition gli attributi specificano dove possono essere impostati i valori della gerarchia di configurazione per una determinata sezione di configurazione. Questi attributi vengono specificati nella <configSections> sezione del file ApplicationHost.config.

Poiché SetAllowDefinition è un metodo statico, è necessario chiamarlo ottenendo un oggetto classe, come nell'esempio seguente.

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.SetAllowDefinition "MachineOnly"  

La sintassi seguente non riesce perché tenta di chiamare SetAllowDefinition su un'istanza concreta della Site classe . La chiamata al metodo causerà un errore "SWbemObjectEx: Non trovato".

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

Nella tabella seguente sono elencati i valori possibili per l'attributo allowDefinition .

Parola chiave Descrizione
Everywhere La sezione può essere impostata in qualsiasi punto della gerarchia.
MachineOnly La sezione può essere impostata solo nel file Machine.config. Nota: Il percorso predefinito per il file Machine.config è %systemroot% Microsoft.NET\Framework\version>\<config\.
MachineToWebRoot La sezione può essere impostata solo nel file Machine.config o nel file di Web.config radice. Nota: Il percorso predefinito per il file radice Web.config è %systemroot% Microsoft.NET\Framework\<version>\config\.
AppHostOnly La sezione può essere impostata solo nel file ApplicationHost.config.
MachineToApplication La sezione può essere impostata solo a livello globale. Per le sezioni di .NET Framework, il livello globale è il file radice Web.config o Machine.config; per le sezioni iis, è il file ApplicationHost.config; e per le applicazioni, è il file Web.config per l'applicazione radice.

Esempio

Nell'esempio seguente viene impostato l'attributo allowDefinition per la sezione Configurazione dell'autenticazione anonima.

' 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"  
  

Requisiti

Tipo Descrizione
Client - IIS 7.0 in Windows Vista
- IIS 7.5 in Windows 7
- IIS 8.0 in Windows 8
- IIS 10.0 in Windows 10
Server - IIS 7.0 in Windows Server 2008
- IIS 7.5 in Windows Server 2008 R2
- IIS 8.0 in Windows Server 2012
- IIS 8.5 in Windows Server 2012 R2
- IIS 10.0 in Windows Server 2016
Prodotto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF WebAdministration.mof

Vedere anche

Classe AnonymousAuthenticationSection
Classe ConfigurationSection
Metodo ConfigurationSection.GetAllowDefinition