Partager via


Classe HandlerAction

Expose les paramètres de configuration des gestionnaires.

Syntaxe

class HandlerAction : CollectionElement  

Méthodes

Cette classe ne contient pas de méthodes.

Propriétés

Le tableau suivant répertorie les propriétés présentées par la classe HandlerAction.

Nom Description
AllowPathInfo Une valeur boolean de lecture/écriture. true si le gestionnaire traite les informations de chemin d'accès complet dans un URI (Uniform Resource Identifier). Sinon, false. Par défaut, il s’agit de false.

Par exemple, lorsque true, cette propriété permet au gestionnaire de traiter un chemin complet comme « /vdir/myisapi.dll/zip » ; lorsque false, cette propriété autorise uniquement le chemin partiel « /zip ».
Modules Valeur string de lecture/écriture qui spécifie le module auquel vous souhaitez mapper un fichier ou une extension. Par défaut, il s’agit de null.
Name Valeur string de lecture/écriture unique requise qui spécifie un nom unique pour le mappage du gestionnaire. La seule propriété clé.
Path Valeur string de lecture/écriture qui spécifie une extension de fichier ou un nom de fichier avec l'extension du type de fichier à gérer. Par défaut, il s’agit de null.
PreCondition Valeur string de lecture/écriture qui spécifie éventuellement les conditions dans lesquelles le gestionnaire peut s'exécuter. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
RequireAccess Énumération sint32 de lecture/écriture qui spécifie les exigences d'accès du gestionnaire. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
ResourceType Énumération sint32 de lecture/écriture qui spécifie le type de mappage pour le gestionnaire. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
ResponseBufferLimit Valeur uint32 de lecture/écriture qui définit la taille maximale, en octets, de la mémoire tampon de réponse pour un gestionnaire de requêtes. Si la mise en mémoire tampon de réponse est activée dans la propriété Bufferde la classe PagesSection, la propriété ResponseBufferLimit contrôle le nombre maximal d'octets qu'une page ASP peut écrire dans la mémoire tampon de réponse avant qu'un vidage ne se produise. La valeur par défaut est 4 194 304 octets.
ScriptProcessor Valeur string de lecture/écriture qui spécifie le chemin d'accès complet aux fichiers d'extension ISAPI .dll ou CGI .exe qui traite la requête, le cas échéant. Si vous spécifiez cette propriété, vous devez spécifier « ISAPIModule » ou « CGIModule » dans la propriété Modules. Par défaut, il s’agit de null.
Type Valeur string de lecture/écriture qui spécifie le chemin d'accès de l'espace de noms d'un gestionnaire managé. Le type spécifié doit être un type managé valide qui se trouve dans le Global Assembly Cache, le répertoire Bin de l'application ou le répertoire app_code. Par défaut, il s’agit de null.
Verb Valeur string de lecture/écriture qui spécifie une liste délimitée par des virgules de verbes. Utilisez cette propriété si vous souhaitez que le mappage s'applique à des types de requêtes spécifiques. Par défaut, il s’agit de null.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la propriété Handlers de la classe HandlersSection.

Le tableau suivant répertorie les valeurs possibles pour la propriété Precondition. Par défaut, il s’agit de null.

Remarque

L'évaluation d'une condition préalable est une logique AND des composants. Comme toute précondition inconnue est évaluée à false, la présence d'une précondition inconnue entraînera l'ignorance de la précondition inconnue.

Valeur Description
appPoolName=pool1;pool2 Le gestionnaire sera utilisé pour tout pool d'applications mentionné dans la liste délimitée par des points-virgules.
appPoolName!=pool1;pool2 Le gestionnaire ne sera utilisé pour aucun pool d'applications nommé dans la liste délimitée par des points-virgules.
bitness32 L'entrée de gestionnaire s'applique uniquement aux processus de travail de 32 bits. Pour les ordinateurs de 64 bits, vous devez utiliser cette valeur pour spécifier les pools d'applications exécutés en mode 32 bits.
bitness64 Le gestionnaire s'applique uniquement aux processus de travail de 64 bits. Pour les ordinateurs de 64 bits, vous devez utiliser cette valeur pour spécifier les pools d'applications qui s'exécutent en mode 64 bits.
integratedMode Le gestionnaire sera utilisé uniquement pour les pools d'applications en mode Intégré.
ISAPIMode Le gestionnaire sera utilisé uniquement pour les pools d'applications en mode ISAPI.
runtimeVersion Le gestionnaire sera utilisé uniquement pour les pools d'applications qui chargent une certaine version du CLR (Common Language Runtime). Pour activer cette condition préalable, ajoutez une chaîne au format vMajorVersion.MinorVersion à la chaîne « runtimeVersion » (par exemple, « runtimeVersionv2.0 »).

Le tableau suivant répertorie les valeurs possibles pour la propriété RequireAccess. La valeur par défaut est 3 (Script).

Remarque

Les paramètres de la propriété AccessPolicy de la classe HandlersSection déterminent les droits autorisés et, par conséquent, quels gestionnaires sont autorisés à s'exécuter.

Valeur Mot clé Description
0 None Le gestionnaire n'a aucune exigence d'accès.
1 Read Le gestionnaire nécessite une autorisation de lecture.
2 Write Le gestionnaire nécessite une autorisation d'écriture.
3 Script Le gestionnaire requiert des droits de script.
4 Execute Le gestionnaire requiert des droits exécutables.

Le tableau suivant répertorie les valeurs possibles pour la propriété ResourceType. La valeur par défaut est 3 (Unspecified).

Remarque

Cette propriété est étiquetée Type de chemin d'accès dans l'IIS Manager.

Valeur Mot clé Description
0 File Le mappage est destiné à un fichier. Si la requête entrante n'est pas mappée à un fichier physique sur le disque, elle n'est pas transmise au gestionnaire.
1 Directory Le mappage est destiné à un répertoire. Si la requête entrante n'est pas mappée à un dossier physique sur le disque, elle n'est pas transmise au gestionnaire.
2 Either Le mappage concerne un fichier ou un répertoire. Si la requête entrante n'est pas mappée pas à un fichier ou à un dossier physique sur le disque, elle n'est pas transmise au gestionnaire.
3 Unspecified Le type de mappage n'est pas spécifié. La requête est transmise au gestionnaire, qu'elle soit ou non mappée à un fichier ou dossier physique sur le disque. Utilisez ce paramètre si vous mappez votre gestionnaire à un nom de fichier (par exemple, « MyHandler.axd ») que vous savez n'existe pas sur le disque.

Exemple

L'exemple suivant ajoute trois catégories différentes de gestionnaires à la section <handlers> : un gestionnaire de mappage de script hérité, deux gestionnaires de modules natifs et un gestionnaire managé.

Remarque

L'ajout ou la suppression d'un élément de configuration modifie la section de configuration sous-jacente, mais pas la variable objet du script qui représente la section de configuration. Pour que la modification apparaisse dans vos scripts, vous devez appeler la méthode WMI Refresh_ sur la variable objet après avoir apporté la modification. Cette opération permet de mettre à jour la variable objet avec les données les plus récentes du magasin de configuration.

' 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  
  

Hiérarchie d'héritage

CollectionElement

HandlerAction

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sous Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sous Windows Server 2008
- IIS 7.5 sous Windows Server 2008 R2
- IIS 8.0 sous Windows Server 2012
- IIS 8.5 sous Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF WebAdministration.mof

Voir aussi

Classe AccessSection
Classe CollectionElement
Classe HandlersSection
Méthode IScriptMapInfo::GetAllowPathInfoForScriptMappings