ConfigurationSection.RevertToParent, méthode

Article
03/19/2024

Rétablit les valeurs de configuration d’une section à leurs valeurs par défaut.

Syntaxe

ConfigurationSection.RevertToParent();  
ConfigurationSection.RevertToParent(PropertyName);

ConfigurationSection.RevertToParent  
ConfigurationSection.RevertToParent(PropertyName)

Paramètres

Nom	Définition
`PropertyName`	Valeur facultative `string` qui contient le nom d’une propriété dans la section de configuration. La propriété peut être imbriquée (par exemple, `oLogSection.RevertToParent("CentralBinaryLogFile.Directory")`.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode permet de supprimer des valeurs de configuration écrites dans un fichier de configuration.

Exemple

L’exemple suivant montre deux façons d’utiliser la méthode RevertToParent :

La première partie rétablit une propriété spécifiée à la valeur par défaut. La ligne suivante de l’exemple rétablit la propriété Enabled de DefaultDocumentSection du site Web par défaut en spécifiant le nom de la propriété en tant que paramètre RevertToParent.
```
oDefaultDocumentSection.RevertToParent("Enabled")  
```
Cela supprime la valeur de false, qui a été spécifiée dans le fichier Web.config du site Web par défaut, et la remplace par la valeur par défaut de true.
La deuxième partie rétablit une section entière aux valeurs par défaut. La ligne suivante de l’exemple rétablit l’intégralité du contenu DefaultDocumentSection du site Web par défaut en spécifiant aucun paramètre pour RevertToParent.
```
oDefaultDocumentSection.RevertToParent  
```
Cela supprime toutes les valeurs de la section de document par défaut dans le fichier Web.config du site Web par défaut. Les valeurs par défaut du site web par défaut remplacent les valeurs supprimées.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the DefaultDocumentSection for the Default Web Site.  
Set oSite=oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "DefaultDocumentSection", oDefaultDocumentSection  
  
' 1. Revert the Enabled property to its default value.  
oDefaultDocumentSection.RevertToParent("Enabled")  
  
' 2. Revert the entire default document section.  
oDefaultDocumentSection.RevertToParent

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 ConfigurationSection
Classe ConfigurationSectionWithCollection
Classe ConfigureObject
Classe DefaultDocumentSection

Partager via