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
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