@ WebHandler

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 del 0 al 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, vea 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

Referencia

Sintaxis de directivas de plantilla de texto

@ Page

IHttpHandler

Handlers

Conceptos

Información general sobre controladores HTTP y módulos HTTP