Méthode ConfigurationSection.GetAllowDefinition

Article
03/19/2024

Récupère l’attribut allowDefinition pour une section de configuration.

Syntaxe

ConfigurationSection.GetAllowDefinition AllowDefinition

ConfigurationSection.GetAllowDefinition(AllowDefinition);

Paramètres

Nom	Définition
`AllowDefinition`	Variable `string` qui reçoit l’attribut `allowDefinition` retourné par la méthode `GetAllowDefinition`. Les valeurs d’attribut possibles sont répertoriées plus loin dans la section Notes.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

allowDefinition attributs spécifient où dans les valeurs de hiérarchie de configuration peuvent être définis pour une section de configuration donnée. Ces attributs sont spécifiés dans la <configSections> section du fichier ApplicationHost.config.

Étant donné que GetAllowDefinition est une méthode statique, vous devez l’appeler en obtenant un objet de classe, comme dans l’exemple suivant.

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

La syntaxe suivante échoue, car elle tente d’appeler GetAllowDefinition sur une instance concrète de la classe Site. L’appel à la méthode entraîne une erreur « SWbemObjectEx : Introuvable ».

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

Le tableau suivant répertorie les valeurs possibles pour l’attribut allowDefinition.

Mot clé	Description
`Everywhere`	La section peut être définie n’importe où dans la hiérarchie.
`MachineOnly`	La section ne peut être définie que dans le fichier Machine.config. Remarque : L’emplacement par défaut du fichier Machine.config est %systemroot% Microsoft.NET\Framework\<version>\config\.
`MachineToWebRoot`	La section ne peut être définie que dans le fichier Machine.config ou dans le fichier Web.config racine. Remarque : L’emplacement par défaut du fichier Web.config racine est %systemroot% Microsoft.NET\Framework\<version>\config\.
`AppHostOnly`	La section ne peut être définie que dans le fichier ApplicationHost.config.
`MachineToApplication`	La section ne peut être définie qu’au niveau global. Pour les sections .NET Framework, le niveau global est le fichier Web.config racine ou Machine.config ; pour les sections IIS, il s’agit du fichier ApplicationHost.config ; et pour les applications, il s’agit du fichier Web.config pour l’application racine.

Exemple

L’exemple suivant affiche l’attribut allowDefinition de la section de configuration de l’authentification anonyme.

' 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

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe AnonymousAuthenticationSection
Classe ConfigurationSection

Partager via