通过

ConfigurationSectionWithCollection.Remove 方法

  • 项目

从配置节的集合中删除指定元素。

语法

ConfigurationSectionWithCollection.Remove collectionName, element;  

ConfigurationSectionWithCollection.Remove collectionName, element

参数设置

名称 定义
collectionName 一个 string 值，该值指定具有要删除元素的集合名称。
element 包含要删除元素的 CollectionElement 对象。

返回值

此方法不返回值。

示例

以下示例显示默认网站的处理程序名称，如果存在，则删除名为“CGI-exe”的处理程序元素，然后再次列出处理程序名称。 该代码将导致以下 XML 添加到默认网站的 Web.config 文件的 <system.webServer> 部分：

<handlers>

<remove name="CGI-exe" />

</handlers>

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Get the handlers section.  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the current handler names.  
Wscript.Echo "---[Current Handler List]---"  
Call DisplayHandlerNames  
  
' Remove the CGI-exe handler by matching its name.  
For Each oHandler In oHandlersSection.Handlers  
     If oHandler.Name = "CGI-exe" Then  
        oHandlersSection.Remove "Handlers", oHandler  
    End If   
Next  
  
' Refresh the oHandlersSection object so that its contents will  
' reflect the updated configuration.  
oHandlersSection.Refresh_      
  
' List the handler names again to show the change.  
Wscript.Echo "---[New Handler List]---"  
Call DisplayHandlerNames  
  
' Provide a subroutine to display handler names.  
Sub DisplayHandlerNames  
    For Each oHandler In oHandlersSection.Handlers  
        WScript.Echo "Handler Name: " & oHandler.Name  
    Next  
    Wscript.Echo  
End Sub

注意：调用 Remove_ 方法会更新基础配置存储，但不会更新内存中运行的 oHandlersSection 对象。 在 oHandlersSection 上调用 Refresh_ 方法将确保如果稍后需要在同一脚本中使用该方法时其数据是准确的。

要求

类型 描述
客户端 - 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

另请参阅

ConfigurationSectionWithCollection 类
HandlerAction 类
HandlersSection 类