Classe HandlersSection

Archivia i gestori per un URL.

Sintassi

class HandlersSection : ConfigurationSectionWithCollection  

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla HandlersSection classe .

Nome	Descrizione
Aggiungere	Ereditato da ConfigurationSectionWithCollection.
Cancella	Ereditato da ConfigurationSectionWithCollection.
Recupero	Ereditato da ConfigurationSectionWithCollection.
GetAllowDefinition	Ereditato da ConfigurationSection.
GetAllowLocation	Ereditato da ConfigurationSection.
Rimuovi	Ereditato da ConfigurationSectionWithCollection.
RevertToParent	Ereditato da ConfigurationSection.
SetAllowDefinition	Ereditato da ConfigurationSection.
SetAllowLocation	Ereditato da ConfigurationSection.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla HandlersSection classe .

Nome	Descrizione
AccessPolicy	Oggetto sint32 che specifica i criteri di accesso per i gestori. I valori possibili sono elencati più avanti nella sezione Osservazioni.
Handlers	Matrice di oggetti HandlerAction .
Location	Ereditato da ConfigurationSection.) Proprietà chiave.
Path	Ereditato da ConfigurationSection.) Proprietà chiave.
SectionInformation	Ereditato da ConfigurationSection.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Questa classe corrisponde alla <handlers> sezione del file ApplicationHost.config.

Nella tabella seguente sono elencati i valori possibili per la AccessPolicy proprietà. Il valore predefinito è 1 (Read).

Valore	Parola chiave	Descrizione
0	None	I gestori non sono consentiti diritti.
1	Read	I gestori sono consentiti autorizzazioni di lettura per file o contenuti di cartelle. Nota: Questo flag è stato denominato AccessRead in IIS 6.0.
2	Write	I gestori possono scrivere nelle directory abilitate nel server o modificare il contenuto di un file abilitato per la scrittura. Nota: Questo flag è stato denominato AccessWrite in IIS 6.0.
4	Execute	I gestori possono eseguire file o contenuti di cartelle, indipendentemente dal tipo di file. Nota: Questo flag è stato denominato AccessExecute in IIS 6.0.
16	Source	I gestori sono autorizzati ad accedere al codice sorgente dello script se è impostato anche il Read flag o Write . Se Read è impostato, i gestori possono leggere il codice sorgente. Se Write è impostato, i gestori possono scrivere nel codice sorgente. Il Source flag non è disponibile se né ReadWrite è impostato né. Nota: Questo flag è stato denominato AccessSource in IIS 6.0.
512	Script	Il gestore è autorizzato a eseguire script. Nota: Questo flag è stato denominato AccessScript in IIS 6.0.
1024	NoRemoteWrite	Il gestore non è autorizzato a scrivere in remoto. Le richieste remote per creare o modificare i file vengono negate. Se il flag è impostato anche, le richieste dal computer che esegue il Write server Web IIS avranno esito positivo. Nota: Questo flag è stato denominato AccessNoRemoteWrite in IIS 6.0.
4096	NoRemoteRead	Il gestore non è consentito leggere in remoto. Le richieste remote per visualizzare i file vengono negate. Se il flag è impostato anche, le richieste dal computer che esegue il Read server Web IIS avranno esito positivo. Nota: Questo flag è stato denominato AccessNoRemoteRead in IIS 6.0.
8192	NoRemoteExecute	Il gestore non è autorizzato a eseguire in remoto. Le richieste remote per l'esecuzione di applicazioni vengono negate. Se il flag è impostato anche, le richieste dal computer che esegue il Execute server Web IIS avranno esito positivo. Nota: Questo flag è stato denominato AccessNoRemoteExecute in IIS 6.0.
16384	NoRemoteScript	Il gestore non è autorizzato a eseguire script in remoto. Le richieste remote per l'esecuzione di contenuto dinamico vengono negate. Se il flag è impostato anche, le richieste dal computer che esegue il Script server Web IIS avranno esito positivo. Nota: Questo flag è stato denominato AccessNoRemoteScript in IIS 6.0.

Esempio

Gli esempi seguenti aggiungono e rimuoveno un gestore dalla <handlers> sezione.

Nota

L'aggiunta o la rimozione di un elemento di configurazione modifica la sezione di configurazione sottostante, ma non la variabile oggetto nello script che rappresenta la sezione di configurazione. Per visualizzare la modifica negli script, è necessario chiamare il metodo WMI Refresh_ nella variabile oggetto dopo aver apportato la modifica. Verrà aggiornata la variabile oggetto con i dati più recenti dall'archivio di configurazione.

' ----------------------------------------------------------  
' The first example adds a handler to the <handlers> section.  
' ----------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a new handler.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "NewHandler"   
oHandler.Path="*.stm"   
oHandler.Verb="GET,POST"   
oHandler.Modules="ServerSideIncludeModule"   
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' ----------------------------------------------------------------  
' The second example removes a handler by using the handler name.  
' ----------------------------------------------------------------  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old handler names.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Remove the CGI-exe handler by name.  
For Each oHandler In oHandlersSection.Handlers  
     If oHandler.Name = "CGI-exe" Then  
        oHandlersSection.Remove "Handlers", oHandler  
    End If   
Next  
  
' Call the WMI Refresh_ method to update the oHandlersSection object.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' This is the sub that displays the handler names.  
Sub DisplayHandlers  
    WScript.Echo   
    For Each oHandler In oHandlersSection.Handlers  
        WScript.Echo "Handler Name: " & oHandler.Name  
    Next  
End Sub  
  

Gerarchia di ereditarietà

Configurationsection

ConfigurationSectionWithCollection

HandlersSection

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