ConfigurationSectionWithCollection.Remove (método)

Recupera el elemento especificado de una colección de una sección de configuración.

Sintaxis

ConfigurationSectionWithCollection.Remove collectionName, element;  

ConfigurationSectionWithCollection.Remove collectionName, element  

Parámetros

Nombre	Definición
collectionName	Valor string que especifica el nombre de la colección que tiene un elemento que se va a eliminar.
element	Objeto CollectionElement que contiene el elemento que se va a quitar.

Valor devuelto

Este método no devuelve ningún valor.

Ejemplo

En el ejemplo siguiente se muestran los nombres de los controladores del sitio web predeterminado, se quita el elemento de controlador denominado "CGI-exe" si está presente y, a continuación, se vuelven a enumerar los nombres del controlador. El código hará que se agregue el siguiente XML a la sección <system.webServer> del archivo Web.config para el sitio web predeterminado:

<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  
  

Nota Al llamar al método Remove_ se actualiza el almacén de configuración subyacente, pero no el objeto oHandlersSection que se ejecuta en memoria. Al llamar al método Refresh_ en oHandlersSection, se asegurará de que sus datos sean precisos si necesita usarlos más adelante en el mismo script.

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

Clase ConfigurationSectionWithCollection
Clase HandlerAction
Clase HandlersSection