Metodo ConfigurationSectionWithCollection.Remove
Rimuove l'elemento specificato da una raccolta in una sezione di configurazione.
Sintassi
ConfigurationSectionWithCollection.Remove collectionName, element;
ConfigurationSectionWithCollection.Remove collectionName, element
Parametri
Nome | Definizione |
---|---|
collectionName |
Valore string che specifica il nome della raccolta con un elemento da rimuovere. |
element |
Oggetto CollectionElement contenente l'elemento da rimuovere. |
Valore restituito
Questo metodo non restituisce valori.
Esempio
Nell'esempio seguente vengono visualizzati i nomi dei gestori per il sito Web predefinito, rimuove l'elemento del gestore denominato "CGI-exe" se presente e quindi elenca di nuovo i nomi del gestore. Il codice causerà l'aggiunta del codice XML seguente alla <system.webServer>
sezione del file Web.config per il sito Web predefinito:
<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 La chiamata al metodo aggiorna l'archivio Remove_
di configurazione sottostante, ma non l'oggetto oHandlersSection
in esecuzione in memoria. La chiamata al metodo su oHandlersSection
garantisce che i Refresh_
dati siano accurati se è necessario usarlo più avanti nello stesso script.
Requisiti
Tipo | Descrizione |
---|---|
Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
Prodotto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
File MOF | WebAdministration.mof |
Vedere anche
Classe ConfigurationSectionWithCollection
Classe HandlerAction
Classe HandlersSection