ConfigurationSection.RevertToParent-Methode

Artikel
03/25/2024

Wiederherstellen von Konfigurationswerten in einem Abschnitt auf ihre Standardwerte.

Syntax

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

ConfigurationSection.RevertToParent  
ConfigurationSection.RevertToParent(PropertyName)

Parameter

Name	Definition
`PropertyName`	Ein optionaler `string`-Wert, der den Namen einer Eigenschaft im Konfigurationsabschnitt enthält. Die Eigenschaft kann geschachtelt werden (z. B. `oLogSection.RevertToParent("CentralBinaryLogFile.Directory")`.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

Diese Methode bietet eine Möglichkeit zum Löschen von Konfigurationswerten, die in eine Konfigurationsdatei geschrieben wurden.

Beispiel

Das folgende Beispiel zeigt zwei Methoden zur Verwendung der RevertToParent-Methode:

Der erste Teil stellt eine angegebene Eigenschaft auf den Standardwert zurück. In der folgenden Zeile aus dem Beispiel wird die Enabled-Eigenschaft der DefaultDocumentSection der Standardwebsite wiederhergestellt, indem der Eigenschaftsname als RevertToParent-Parameter angegeben wird.
```
oDefaultDocumentSection.RevertToParent("Enabled")  
```
Dadurch wird der Wert von false, der in der Web.config-Datei der Standardwebsite angegeben wurde, entfernt und durch den Standardwert von true ersetzt.
Der zweite Teil stellt einen gesamten Abschnitt auf die Standardwerte zurück. In der folgenden Zeile aus dem Beispiel wird der gesamte DefaultDocumentSection-Inhalt der Standardwebsite wiederhergestellt, indem keine Parameter für RevertToParent angegeben werden.
```
oDefaultDocumentSection.RevertToParent  
```
Dadurch werden alle Werte aus dem Standarddokumentabschnitt in der Datei Web.config der Standardwebsite entfernt. Die Standardwerte der Standardwebsite ersetzen die entfernten Werte.

' 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

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

ConfigurationSection-Klasse
ConfigurationSectionWithCollection-Klasse
ConfiguredObject-Klasse
DefaultDocumentSection-Klasse

Freigeben über