HandlerAction-Klasse

Macht Konfigurationseinstellungen für Handler verfügbar.

Syntax

class HandlerAction : CollectionElement  

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der HandlerAction Klasse verfügbar gemacht werden.

Name	Beschreibung
AllowPathInfo	Ein Lese-/Schreibboolean-Wert. true wenn der Handler vollständige Pfadinformationen in einem URI (Uniform Resource Identifier) verarbeitet; andernfalls, false. Der Standardwert ist false. Wenn truebeispielsweise diese Eigenschaft dem Handler das Verarbeiten eines vollständigen Pfads wie "/vdir/myisapi.dll/zip" ermöglicht; wenn falsediese Eigenschaft nur den teiliellen Pfad "/zip" zulässt.
Modules	Ein Lese-/Schreibstring-Wert , der das Modul angibt, dem Sie eine Datei oder Erweiterung zuordnen möchten. Der Standardwert ist null.
Name	Ein erforderlicher eindeutiger Lese-/Schreibstring-Wert , der einen eindeutigen Namen für die Handlerzuordnung angibt. Die einzige Schlüsseleigenschaft.
Path	Ein Lese-/Schreibstring-Wert , der eine Dateierweiterung oder einen Dateinamen mit der Erweiterung des zu verarbeitenden Dateityps angibt. Der Standardwert ist null.
PreCondition	Ein Lese-/Schreibstring-Wert , der optional Bedingungen angibt, unter denen der Handler ausgeführt werden kann. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
RequireAccess	Eine Lese-/Schreibaufzählung sint32 , die Handlerzugriffsanforderungen angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
ResourceType	Eine Lese-/Schreibaufzählung sint32 , die den Zuordnungstyp für den Handler angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
ResponseBufferLimit	Ein Lese-/Schreibwert uint32 , der die maximale Größe des Antwortpuffers für einen Anforderungshandler in Bytes festlegt. Wenn die Antwortpufferung in der Buffer Eigenschaft der PagesSection-Klasse aktiviert ist, steuert die ResponseBufferLimit Eigenschaft die maximale Anzahl von Bytes, die eine ASP-Seite in den Antwortpuffer schreiben kann, bevor ein Leerlauf erfolgt. Der Standard ist 4194304 (Bytes).
ScriptProcessor	Ein Lese-/Schreibstring-Wert , der den vollständigen Pfad zur ISAPI-Erweiterung angibt, .dll Datei oder CGI .exe Datei, die die Anforderung verarbeitet, falls erforderlich. Wenn Sie diese Eigenschaft angeben, müssen Sie entweder "ISAPIModule" oder "CGIModule" in der Modules Eigenschaft angeben. Der Standardwert ist null.
Type	Ein Lese-/Schreibstring-Wert , der den Namespacepfad eines verwalteten Handlers angibt. Der angegebene Typ muss ein gültiger verwalteter Typ sein, der sich im globalen Assemblycache, im Bin-Verzeichnis der Anwendung oder im Verzeichnis app_code befindet. Der Standardwert ist null.
Verb	Ein Lese-/Schreibstring-Wert, der eine durch Trennzeichen getrennte Liste von Verben angibt. Verwenden Sie diese Eigenschaft, wenn die Zuordnung auf bestimmte Anforderungstypen angewendet werden soll. Der Standardwert ist null.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der Handlers Eigenschaft der HandlersSection-Klasse enthalten.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Precondition Eigenschaft angezeigt. Der Standardwert ist null.

Hinweis

Die Auswertung einer Vorbedingung ist ein Logisches AND der Komponenten. Da eine unbekannte Vorbedingung als falseausgewertet wird, wird das Vorhandensein einer unbekannten Vorbedingung dazu führen, dass die unbekannte Voraussetzung ignoriert wird.

Wert	Beschreibung
appPoolName=pool1;pool2	Der Handler wird für jeden Anwendungspool verwendet, der in der durch Semikolons getrennten Liste benannt ist.
appPoolName!=pool1;pool2	Der Handler wird nicht für einen Anwendungspool verwendet, der in der durch Semikolons getrennten Liste benannt ist.
bitness32	Der Handlereintrag gilt nur für 32-Bit-Arbeitsprozesse. Für 64-Bit-Computer sollten Sie diesen Wert verwenden, um anzugeben, welche Anwendungspools im 32-Bit-Modus ausgeführt werden.
bitness64	Der Handler gilt nur für 64-Bit-Arbeitsprozesse. Für 64-Bit-Computer sollten Sie diesen Wert verwenden, um anzugeben, welche Anwendungspools im 64-Bit-Modus ausgeführt werden.
integratedMode	Der Handler wird nur für Anwendungspools im integrierten Modus verwendet.
ISAPIMode	Der Handler wird nur für Anwendungspools im ISAPI-Modus verwendet.
runtimeVersion	Der Handler wird nur für Anwendungspools verwendet, die eine bestimmte Version der Common Language Runtime (CLR) laden. Um diese Voraussetzung zu aktivieren, fügen Sie eine Zeichenfolge im Format vMajorVersion.MinorVersion zur Zeichenfolge "runtimeVersion" (z. B. "runtimeVersionv2.0") hinzu.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die RequireAccess Eigenschaft angezeigt. Der Standardwert ist 3 (Script).

Hinweis

Einstellungen in der AccessPolicy Eigenschaft der HandlersSection-Klasse bestimmen, welche Rechte zulässig sind und welche Handler ausgeführt werden dürfen.

Wert	Schlüsselwort	Beschreibung
0	None	Der Handler hat keine Zugriffsanforderungen.
1	Read	Der Handler erfordert Leseberechtigungen.
2	Write	Der Handler erfordert Schreibberechtigungen.
3	Script	Der Handler erfordert Skriptrechte.
4	Execute	Der Handler erfordert ausführbare Rechte.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die ResourceType Eigenschaft angezeigt. Der Standardwert ist 3 (Unspecified).

Hinweis

Diese Eigenschaft ist als Pfadtyp im IIS-Manager bezeichnet .

Wert	Schlüsselwort	Beschreibung
0	File	Die Zuordnung ist für eine Datei vorgesehen. Wenn die eingehende Anforderung keiner physischen Datei auf dem Datenträger zugeordnet ist, wird die Anforderung nicht an den Handler übergeben.
1	Directory	Die Zuordnung ist für ein Verzeichnis vorgesehen. Wenn die eingehende Anforderung keinem physischen Ordner auf dem Datenträger zugeordnet ist, wird die Anforderung nicht an den Handler übergeben.
2	Either	Die Zuordnung ist entweder für eine Datei oder ein Verzeichnis vorgesehen. Wenn die eingehende Anforderung keiner physischen Datei oder einem physischen Ordner auf dem Datenträger zugeordnet ist, wird die Anforderung nicht an den Handler übergeben.
3	Unspecified	Der Zuordnungstyp ist nicht angegeben. Die Anforderung wird unabhängig davon, ob die Anforderung einer physischen Datei oder einem Ordner auf dem Datenträger zugeordnet ist, an den Handler übergeben. Verwenden Sie diese Einstellung, wenn Sie den Handler einem Dateinamen zuordnen (z. B. "MyHandler.axd"), von dem Sie wissen, dass auf dem Datenträger nicht vorhanden ist.

Beispiel

Im folgenden Beispiel werden dem <handlers> Abschnitt drei verschiedene Kategorien von Handlern hinzugefügt: ein Legacy-Skriptzuordnungshandler, zwei systemeigene Modulhandler und ein verwalteter Handler.

Hinweis

Das Hinzufügen oder Entfernen eines Konfigurationselements ändert den zugrunde liegenden Konfigurationsabschnitt, aber nicht die Objektvariable im Skript, die den Konfigurationsabschnitt darstellt. Damit die Änderung in Ihren Skripts angezeigt wird, müssen Sie die WMI-Methode Refresh_ für die Objektvariable aufrufen, nachdem Sie die Änderung vorgenommen haben. Dadurch wird die Objektvariable mit den neuesten Daten aus dem Konfigurationsspeicher aktualisiert.

' 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  
  

Vererbungshierarchie

CollectionElement

HandlerAction

Anforderungen

type	Beschreibung
Client	IIS 7.0 unter Windows Vista. IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

AccessSection-Klasse
CollectionElement-Klasse
HandlersSection-Klasse
IScriptMapInfo::GetAllowPathInfoForScriptMappings Method