<add>, élément de <httpHandlers>

Article
04/11/2008

Ajoute un gestionnaire à une application. Un gestionnaire est une classe IHttpHandler ou IHttpHandlerFactory qui traite les demandes d'URL spécifiques.

<configuration>
   <system.web>
      <httpHandlers>
         <add>

<add verb="verb list"      path="path/wildcard"      type="type,assemblyname"     validate="true|false"/>

Attributs requis

Attribut	Description
verb	La liste des verbes peut être soit une liste de verbes HTTP avec la virgule comme séparateur (par exemple « GET, PUT, POST »), soit un mappage de démarrage de script (par exemple le caractère générique * [astérisque]).
path	L'attribut path peut contenir soit un seul chemin d'accès d'URL, soit une simple chaîne utilisant un caractère générique (par exemple, *.aspx).
type	Spécifie une combinaison classe/assembly utilisant la virgule comme séparateur. ASP.NET recherche la DLL d'assembly d'abord dans le répertoire \bin privé de l'application, puis dans le cache de l'assembly système.

Attribut facultatif

Attribut	Description
validate	Si validate a la valeur false, ASP.NET ne tentera de charger la classe que lorsque la demande correspondante arrivera, ce qui risque de retarder l'erreur, mais permet d'améliorer le temps de démarrage.

Notes

Les paramètres <httpHandlers> sont hérités par les sous-répertoires.

Les directives <add> sont traitées dans l'ordre séquentiel du haut vers le bas. Si plusieurs sous-éléments <add> spécifient la même combinaison verb/path, la dernière balise <add> se substitue aux autres.

Microsoft Internet Information Services (IIS) utilise un concept qui lui est propre pour mapper des extensions vers des applications ISAPI. Pour que les paramètres d'une extension donnée de cette section soient pris en compte, l'extension doit être mappée dans IIS à l'ISAPI ASP.NET. Pour les extensions non standard (c'est-à-dire autres que .aspx, .asmx, .asax, etc.), vous devez configurer IIS.

Exemple

L'exemple suivant mappe toutes les demandes HTTP de fichiers avec pour extension de nom de fichier .New à la classe MyHandler.New et les demandes HTTP GET et HTTP HEAD de fichiers avec pour pour extension de nom de fichier .MyNewFileExtension à la classe MyHandler.MNFEHandler. Ces deux classes se trouvent dans l'assembly MyHandler qui se trouve dans le fichier MyHandler.dll.

<configuration>
   <system.web>
      <httpHandlers>
         <add verb="*" 
              path="*.New" 
              type="MyHandler.New,MyHandler"/>
         <add verb="GET,HEAD" 
              path="*.MyNewFileExtension" 
              type="MyHandler.MNFEHandler,MyHandler.dll"/>
     </httpHandlers>
   <system.web>
</configuration>

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.Configuration.HttpHandlersSectionHandler

Voir aussi

<httpHandlers>, élément | Configuration ASP.NET | Schéma des paramètres ASP.NET

Partager via