<httpHandlers>, élément

Article
04/11/2008

Mappe les demandes entrantes à la classe IHttpHandler ou IHttpHandlerFactory appropriée, en fonction de l'URL et du verbe HTTP spécifiés dans la demande.

<configuration>
<system.web>
<httpHandlers>

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

Sous-balises

Sous-balise	Description
<add>	Spécifie le mappage verb/path à une classe IHttpHandler ou IHttpHandlerFactory.
<remove>	Supprime un mappage verb/path à une classe IHttpHandler. La directive <remove> doit correspondre exactement à la combinaison verb/path d'une directive <add> précédente. Les caractères génériques ne sont pas pris en charge.
<clear>	Supprime tous les mappages IHttpHandler actuellement contenus dans ou hérités par le fichier Web.config spécifié.

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.

Notez que 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.), l'utilisateur doit 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.HttpHandlersConfigHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET

Partager via