ConfigurationSection.RevertToParent 方法

将节中的配置值还原为默认值。

语法

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

参数设置

名称 定义
PropertyName 一个可选 string 值,包含配置节中的属性的名称。 该属性可以嵌套(如 oLogSection.RevertToParent("CentralBinaryLogFile.Directory"))。

返回值

此方法不返回值。

注解

使用此方法可删除已写入配置文件的配置值。

示例

以下示例演示 RevertToParent 方法的两种使用方法:

  1. 第一部分将指定属性还原为默认值。 示例的以下行通过指定属性名为 RevertToParent 参数来还原默认网站 DefaultDocumentSectionEnabled 属性。

    oDefaultDocumentSection.RevertToParent("Enabled")  
    

    这会删除默认网站 Web.config 文件中指定的值 false,并将其替换为默认值 true

  2. 第二部分将整节还原为默认值。 示例的以下行通过不为 RevertToParent 指定任何参数,还原默认网站的整个 DefaultDocumentSection 内容。

    oDefaultDocumentSection.RevertToParent  
    

    这会删除默认网站 Web.config 文件中默认文档节中的所有值。 默认网站的默认值将替代已删除的值。

' 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  
  

要求

类型 描述
客户端 - IIS 7.0(在 Windows Vista 上)
- IIS 7.5(在 Windows 7 上)
- IIS 8.0(在 Windows 8 上)
- IIS 10.0(在 Windows 10 上)
服务器 - IIS 7.0(在 Windows Server 2008 上)
- IIS 7.5(在 Windows Server 2008 R2 上)
- IIS 8.0(在 Windows Server 2012 上)
- IIS 8.5(在 Windows Server 2012 R2 上)
- IIS 10.0(在 Windows Server 2016 上)
产品 - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件 WebAdministration.mof

另请参阅

ConfigurationSection 类
ConfigurationSectionWithCollection 类
ConfiguredObject 类
DefaultDocumentSection 类