Elemento <httpHandlers>

Asigna a las solicitudes entrantes la clase IHttpHandler o IHttpHandlerFactory correspondiente, según la dirección URL y el verbo HTTP especificado en la solicitud.

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

Subetiquetas

Subetiqueta	Descripción
<add>	Especifica la asignación de una clase IHttpHandler o IHttpHandlerFactory a un par de verbo y ruta.
<remove>	Quita una asignación de una clase IHttpHandler a un par de verbo y ruta. La directiva <remove> debe coincidir exactamente con la combinación de verbo y ruta de una directiva <add> anterior. No se admiten los caracteres comodín.
<clear>	Quita todas las asignaciones de IHttpHandler configuradas o heredadas actualmente por el archivo Web.config especificado.

Comentarios

Los subdirectorios heredan las opciones de <httpHandlers>.

Las directivas <add> se procesan secuencialmente, de arriba a abajo. Si dos o más subelementos <add> especifican la misma combinación de verbo y ruta, el último <add> prevalece sobre el resto.

Observe que los Servicios de Microsoft Internet Information Server (IIS) tienen su propio concepto de asignación de ISAPI a extensiones. Para que la opción correspondiente a una extensión determinada tenga efecto, debe haberse asignado la ISAPI de ASP.NET a la extensión en IIS. En el caso de extensiones no estándar (distintas de .aspx, .asmx, .asax, etcétera), el usuario debe configurar IIS.

Ejemplo

El ejemplo siguiente asigna todas las solicitudes HTTP de archivos con la extensión .New a la clase MyHandler.New, y las solicitudes HTTP GET y HTTP HEAD de archivos con la extensión .MyNewFileExtension a la clase MyHandler.MNFEHandler. Ambas clases se encuentran en el ensamblado MyHandler que está en el archivo 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>

Requisitos

Contenido dentro de: <system.web>

Plataforma Web: IIS 5.0, IIS 5.1, IIS 6.0

Archivo de configuración: Machine.config, Web.config

Controlador de la sección de configuración: System.Web.Configuration.HttpHandlersConfigHandler

Vea también

Configuración de ASP.NET | Esquema de configuración de ASP.NET