Méthode ConfigurationSection.SetAllowDefinition

Article
03/22/2024

Définit l’attribut allowDefinition d’une section de configuration.

Syntaxe

ConfigurationSection.SetAllowDefinition(AllowDefinition)

ConfigurationSection.SetAllowDefinition(AllowDefinition);

Paramètres

Nom	Définition
`AllowDefinition`	Une variable `string` qui spécifie la valeur à laquelle l’attribut `allowDefinition` sera défini. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

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

Comme SetAllowDefinition 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.SetAllowDefinition "MachineOnly"

La syntaxe suivante échoue, car elle tente d’appeler SetAllowDefinition 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.SetAllowDefinition "MachineOnly"

Le tableau ci-dessous 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 racine Web.config. Remarque : L’emplacement par défaut du fichier racine 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 racine Web.config ou Machine.config ; pour les sections IIS, il s’agit du fichier ApplicationHost.config ; pour les applications, il s’agit du fichier Web.config pour l’application racine.

Exemple

L’exemple suivant définit l’attribut allowDefinition de la section configuration de l’authentification anonyme.

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

Spécifications

Type	Description
Client	- IIS 7.0 sous Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sous Windows Server 2012 - IIS 8.5 sous 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
Méthode ConfigurationSection.GetAllowDefinition

Partager via