@ WebHandler
Actualización: noviembre 2007
Define atributos y opciones de compilación para los archivos de controladores HTTP (.ashx).
<%@ WebHandler attribute="value" [attribute="value"...] %>
Atributos
Class
Especifica el nombre de la clase que se compilará dinámicamente cuando se solicite el controlador. Este valor puede hacer referencia a cualquier clase que se herede de IHttpHandler y puede incluir un nombre de clase completo.CodeBehind
Especifica el nombre del archivo compilado que contiene la clase asociada al controlador. Este atributo no se usa en tiempo de ejecución.Nota
Este atributo se incluye para permitir la compatibilidad con versiones anteriores de ASP.NET.
CompilerOptions
Especifica una cadena que contiene las opciones que se utilizan para compilar el controlador. En C# y Visual Basic, se trata de una secuencia de modificadores de línea de comandos del compilador. Para obtener más información sobre las opciones del compilador, consulte Opciones del compilador de C# y Compilador de Visual Basic.Debug
true si el controlador se debe compilar con símbolos de depuración; de lo contrario, false. Dado que este valor de configuración afecta al rendimiento, establezca el atributo en true sólo durante el desarrollo.Description
Proporciona una descripción textual del controlador. El analizador de ASP.NET no tiene en cuenta este valor.Language
Especifica el lenguaje utilizado al compilar todo el código dentro del controlador. Los valores pueden representar cualquier lenguaje de .NET Framework, incluidos Visual Basic, C# o JScript. Sólo se puede usar un lenguaje para cada controlador.WarningLevel
Indica el nivel de advertencia del compilador en el que el compilador debe tratar las advertencias como errores y, en ese caso, detener la compilación de la página. Los posibles niveles de advertencia van de 0 a 4. Para obtener más información, vea la propiedad WarningLevel.
Comentarios
Esta directiva sólo es válida en los archivos utilizados como controladores HTTP. De forma predeterminada, ASP.NET trata los archivos con la extensión de nombre de archivo .ashx como controladores.
Nota
Si no desea utilizar la extensión de nombre de archivo .ashx para los controladores, puede crear un controlador como una clase estándar (un archivo .cs o .vb) que implemente la interfaz IHttpHandler. Los archivos de clase de controlador no requieren la directiva @ WebHandler. Debe registrar la extensión de nombre de archivo que desee con ASP.NET. Para obtener información detallada, consulte Cómo: Registrar controladores HTTP.
Sólo puede incluir una directiva @ WebHandler para cada archivo. Sólo puede definir un atributo Language para cada directiva @ WebHandler porque sólo se puede utilizar un lenguaje para cada controlador.
Nota
La directiva @ WebHandler tiene varios atributos en común con otras directivas que se aplican a un archivo de código fuente completo, como la directiva @ Page que se utiliza en archivos .aspx para las páginas Web.
Si desea definir varios atributos para la directiva @ WebHandler, separe cada par de atributo y valor con un solo espacio. No incluya un espacio a ambos lados del signo de igualdad (=) que conecta el atributo con su valor.
Ejemplo
En el ejemplo de código siguiente se indica al compilador de páginas ASP.NET que utilice Visual Basic como el lenguaje de código en línea y se especifica un nombre de clase.
<%@ WebHandler Language="VB" Class="MyTestHandler" %>
Vea también
Conceptos
Información general sobre controladores HTTP y módulos HTTP