ConfigurationSection.SetAllowDefinition-Methode

Artikel
03/25/2024

Legt das allowDefinition-Atribut für einen Konfigurationsabschnitt fest.

Syntax

ConfigurationSection.SetAllowDefinition(AllowDefinition)

ConfigurationSection.SetAllowDefinition(AllowDefinition);

Parameter

Name	Definition
`AllowDefinition`	Eine `string`-ariable, die den Wert angibt, auf den das `allowDefinition`-Attribut festgelegt wird. Die möglichen Attributwerte werden weiter unten im Abschnitt Hinweise aufgeführt.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

allowDefinition-Attribute geben an, wo in den Konfigurationshierarchiewerten für einen bestimmten Konfigurationsabschnitt festgelegt werden kann. Diese Attribute werden im <configSections>-Abschnitt der ApplicationHost.config-Datei angegeben.

Da SetAllowDefinition eine statische Methode ist, sollten Sie sie aufrufen, indem Sie wie im folgenden Beispiel ein Klassenobjekt abrufen.

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

Die folgende Syntax schlägt fehl, da versucht wird, SetAllowDefinition auf eine konkrete Instanz der Site-Klasse aufzurufen. Der Aufruf der Methode führt zu einem Fehler „SWbemObjectEx: Nicht gefunden“.

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

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die allowDefinition-Eigenschaft angezeigt.

Schlüsselwort	Beschreibung
`Everywhere`	Der Abschnitt kann an einer beliebigen Stelle in der Hierarchie festgelegt werden.
`MachineOnly`	Der Abschnitt kann nur in der Datei Machine.config festgelegt werden. Hinweis: Der Standardspeicherort für die Datei Machine.config ist %systemroot% Microsoft.NET\Framework\<version>\config\.
`MachineToWebRoot`	Der Abschnitt kann nur in der Datei Machine.config oder in der Stammdatei Web.config festgelegt werden. Hinweis: Der Standardspeicherort für die Stammdatei Web.config ist %systemroot% Microsoft.NET\Framework\<version>\config\.
`AppHostOnly`	Der Abschnitt kann nur in der Datei ApplicationHost.config festgelegt werden.
`MachineToApplication`	Der Abschnitt kann nur auf globaler Ebene festgelegt werden. Für .NET Framework-Abschnitte ist die globale Ebene die Stammdatei Web.config oder Machine.config; für IIS-Abschnitte ist es die ApplicationHost.config-Datei; und für Anwendungen ist es die Web.config-Datei für die Stammanwendung.

Beispiel

Im folgenden Beispiel wird das allowDefinition-Attribut für den Konfigurationsabschnitt der anonymen Authentifizierung festgelegt.

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

Anforderungen

type	Beschreibung
Client	IIS 7.0 unter Windows Vista IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

AnonymousAuthenticationSection-Klasse
ConfigurationSection-Klasse
ConfigurationSection.GetAllowDefinition-Methode

Freigeben über