Classe HandlerAction

Espone le impostazioni di configurazione per i gestori.

Sintassi

class HandlerAction : CollectionElement  

Metodi

Questa classe non contiene metodi.

Proprietà

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

Nome	Descrizione
AllowPathInfo	Valore di lettura/scrittura boolean . true se il gestore elabora le informazioni complete sul percorso in un URI (Uniform Resource Identifier); in caso contrario, false. Il valore predefinito è false. Ad esempio, quando true, questa proprietà consentirà al gestore di elaborare un percorso completo, ad esempio "/vdir/myisapi.dll/zip"; quando false, questa proprietà consentirà solo il percorso parziale "/zip".
Modules	Valore di lettura/scrittura string che specifica il modulo a cui si desidera eseguire il mapping di un file o un'estensione. Il valore predefinito è null.
Name	Valore di lettura/scrittura string univoco obbligatorio che specifica un nome univoco per il mapping del gestore. L'unica proprietà della chiave.
Path	Valore di lettura/scrittura string che specifica un'estensione di file o un nome di file con estensione del tipo di file da gestire. Il valore predefinito è null.
PreCondition	Valore di lettura/scrittura string che specifica facoltativamente le condizioni in cui il gestore può essere eseguito. I valori possibili sono elencati più avanti nella sezione Osservazioni.
RequireAccess	Enumerazione di lettura/scrittura sint32 che specifica i requisiti di accesso del gestore. I valori possibili sono elencati più avanti nella sezione Osservazioni.
ResourceType	Enumerazione di lettura/scrittura sint32 che specifica il tipo di mapping per il gestore. I valori possibili sono elencati più avanti nella sezione Osservazioni.
ResponseBufferLimit	Valore di lettura/scrittura uint32 che imposta le dimensioni massime, in byte, del buffer di risposta per un gestore di richieste. Se il Buffer buffer delle risposte è abilitato nella proprietà della classe PagesSection , la ResponseBufferLimit proprietà controlla il numero massimo di byte che una pagina ASP può scrivere nel buffer di risposta prima che si verifichi uno scaricamento. Il valore predefinito è 4194304 byte.
ScriptProcessor	Valore di lettura/scrittura string che specifica il percorso completo dell'estensione ISAPI .dll file o CGI .exe file che elabora la richiesta, se appropriato. Se si specifica questa proprietà, è necessario specificare "ISAPIModule" o "CGIModule" nella Modules proprietà . Il valore predefinito è null.
Type	Valore di lettura/scrittura string che specifica il percorso dello spazio dei nomi di un gestore gestito. Il tipo specificato deve essere un tipo gestito valido presente nella Global Assembly Cache, nella directory Bin dell'applicazione o nella directory app_code. Il valore predefinito è null.
Verb	Valore di lettura/scrittura string che specifica un elenco delimitato da virgole di verbi. Utilizzare questa proprietà se si desidera che il mapping venga applicato a tipi di richiesta specifici. Il valore predefinito è null.

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella Handlers proprietà della classe HandlersSection .

Nella tabella seguente sono elencati i valori possibili per la Precondition proprietà . Il valore predefinito è null.

Nota

La valutazione di una precondizione è logica AND dei componenti. Poiché qualsiasi precondizione sconosciuta restituisce false, la presenza di una precondizione sconosciuta causerà l'ignorare la precondizione sconosciuta.

Valore	Descrizione
appPoolName=pool1;pool2	Il gestore verrà usato per qualsiasi pool di applicazioni denominato nell'elenco delimitato da punto e virgola.
appPoolName!=pool1;pool2	Il gestore non verrà usato per qualsiasi pool di applicazioni denominato nell'elenco delimitato da punto e virgola.
bitness32	La voce del gestore si applica solo ai processi di lavoro a 32 bit. Per i computer a 64 bit, è consigliabile usare questo valore per specificare i pool di applicazioni eseguiti in modalità a 32 bit.
bitness64	Il gestore si applica solo ai processi di lavoro a 64 bit. Per i computer a 64 bit, è consigliabile usare questo valore per specificare i pool di applicazioni eseguiti in modalità a 64 bit.
integratedMode	Il gestore verrà usato solo per i pool di applicazioni in modalità integrata.
ISAPIMode	Il gestore verrà usato solo per i pool di applicazioni in modalità ISAPI.
runtimeVersion	Il gestore verrà usato solo per i pool di applicazioni che caricano una determinata versione di Common Language Runtime (CLR). Per abilitare questa precondizione, aggiungere una stringa nel formatov MajorVersion. MinorVersion alla stringa "runtimeVersion", ad esempio "runtimeVersionv2.0".

Nella tabella seguente sono elencati i valori possibili per la RequireAccess proprietà . Il valore predefinito è 3 (Script).

Nota

Le impostazioni nella AccessPolicy proprietà della classe HandlersSection determinano quali diritti sono consentiti e, di conseguenza, quali gestori sono autorizzati a eseguire.

Valore	Parola chiave	Descrizione
0	None	Il gestore non ha requisiti di accesso.
1	Read	Il gestore richiede l'autorizzazione di lettura.
2	Write	Il gestore richiede l'autorizzazione di scrittura.
3	Script	Il gestore richiede diritti di script.
4	Execute	Il gestore richiede diritti eseguibili.

Nella tabella seguente sono elencati i valori possibili per la ResourceType proprietà . Il valore predefinito è 3 (Unspecified).

Nota

Questa proprietà è denominata Tipo di percorso in Gestione IIS.

Valore	Parola chiave	Descrizione
0	File	Il mapping è relativo a un file. Se la richiesta in ingresso non viene mappata a un file fisico su disco, la richiesta non viene passata al gestore.
1	Directory	Il mapping è relativo a una directory. Se la richiesta in ingresso non viene mappata a una cartella fisica su disco, la richiesta non viene passata al gestore.
2	Either	Il mapping è relativo a un file o a una directory. Se la richiesta in ingresso non viene mappata a un file fisico o a una cartella su disco, la richiesta non viene passata al gestore.
3	Unspecified	Il tipo di mapping non è specificato. La richiesta viene passata al gestore indipendentemente dal fatto che la richiesta venga mappata a un file fisico o a una cartella su disco. Usare questa impostazione se si esegue il mapping del gestore a un nome file,ad esempio "MyHandler.axd") che non esiste su disco.

Esempio

Nell'esempio seguente vengono aggiunte tre diverse categorie di gestori alla <handlers> sezione: un gestore mappa script legacy, due gestori di moduli nativi e un gestore gestito.

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.

' 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 list of handlers.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a legacy script map handler.  
' The required properties are Name, Modules, and ScriptProcessor.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "ASPClassic"   
oHandler.Path="*.asp"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Modules="ISAPIModule"   
oHandler.ResourceType= 0 '0 is "File"  
oHandler.ScriptProcessor = "%windir%\system32\inetsrv\asp.dll"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for static files.  
' The required properties are Name, Modules, and Path.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "StaticFile"   
oHandler.Path="*"   
oHandler.Verb="*"   
oHandler.Modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
oHandler.ResourceType=2  
oHandler.RequireAccess=1  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for ISAPI DLLs.  
' The required properties are Name, Modules, and Path.  
oHandler.Name = "ISAPI-dll"   
oHandler.Path="*.dll"   
oHandler.Verb="*"   
oHandler.Modules="ISAPIModule"  
oHandler.ResourceType=0  
oHandler.RequireAccess=4  
oHandler.AllowPathInfo=True  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Add a managed handler.  
' The required properties are Name, Path, and Type.   
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "TraceHandler-Integrated"   
oHandler.Path="trace.axd"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Type="System.Web.Handlers.TraceHandler"  
oHandler.PreCondition="integratedMode"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object variable.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' Provide a sub to display the handler names.  
Sub DisplayHandlers  
    For Each oHandler In oHandlersSection.Handlers  
         WScript.Echo "Name: " & oHandler.Name  
    Next  
    WScript.Echo  
End Sub  
  

Gerarchia di ereditarietà

CollectionElement

HandlerAction

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 AccessSection
Classe CollectionElement
Classe HandlersSection
Metodo IScriptMapInfo::GetAllowPathInfoForScriptMappings