Compartir a través de


Elemento <add> para <httpHandlers>

Agrega un controlador a una aplicación. Un controlador es una clase IHttpHandler o IHttpHandlerFactory que procesa solicitudes de direcciones URL específicas.

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

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

Atributos requeridos

Atributo Descripción
verb La lista de verbos puede ser una lista separada por comas de verbos HTTP (por ejemplo, "GET, PUT, POST") o una asignación de secuencias de comandos de inicio (por ejemplo, el carácter comodín * [asterisco]).
path El atributo path puede contener una ruta de acceso a una dirección URL o una cadena comodín (por ejemplo, *.aspx).
type Especifica una combinación de clase y ensamblado separada por comas. ASP.NET busca el archivo DLL del ensamblado primero en el directorio \bin privado de la aplicación y, después, en la caché de ensamblados del sistema.

Atributo opcional

Atributo Descripción
validate Si validate es false, ASP.NET no intentará cargar la clase hasta que llegue la solicitud correspondiente, lo que mejora el tiempo de inicio, aunque puede retrasar la aparición de un error.

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.

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), se 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.HttpHandlersSectionHandler

Vea también

Elemento <httpHandlers> | Configuración de ASP.NET | Esquema de configuración de ASP.NET