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