Compartir a través de


@ Control

Actualización: noviembre 2007

Define los atributos específicos de control de usuario (archivo .ascx) utilizados por el analizador y el compilador de páginas de ASP.NET. Esta directiva sólo se puede utilizar con Controles de usuario ASP.NET (cuyo código fuente se incluye en archivos .ascx).

<%@ Control attribute="value" [attribute="value" ... ] %>

Atributos

  • AutoEventWireup
    Indica si los eventos del control se conectan automáticamente. Es true si la autoconexión de eventos está habilitada, en caso contrario, es false. El valor predeterminado es true. Para obtener más información, vea Modelo de eventos de control de servidor Web ASP.NET.

  • ClassName
    Cadena que especifica el nombre de la clase del control que se compilará dinámicamente cuando el control se solicite. Este valor puede ser cualquier nombre de clase válido y puede incluir el espacio de nombres completo de una clase (un nombre de clase completo). Si no se especifica un valor para este atributo, el nombre de clase del control compilado se basa en el nombre de archivo del control.

    Otra página o control puede hacer referencia al nombre de clase asignado al control mediante la directiva @ Reference.

  • CodeBehind
    Especifica el nombre del archivo compilado que contiene la clase asociada al control. Este atributo no se usa en tiempo de ejecución.

    Nota

    Este atributo se incluye por compatibilidad con las versiones anteriores de ASP.NET, para implementar la característica de código subyacente. En ASP.NET 2.0, se recomienda utilizar el atributo CodeFile para especificar el nombre del archivo de código fuente, junto con el atributo Inherits para especificar el nombre completo de la clase.

  • CodeFile
    Especifica una ruta de acceso al archivo de código subyacente al que se hace referencia para el control. Este atributo se utiliza junto con el atributo Inherits para asociar un archivo de código fuente subyacente a un control de usuario. El atributo sólo es válido para los controles compilados.

  • CodeFileBaseClass
    Especifica una ruta de acceso a una clase base para un control y su clase de código subyacente asociada. Este atributo es opcional, pero, cuando se utiliza, el atributo CodeFile también debe estar presente. Use este atributo cuando desee implementar un escenario compartido, en el que se definen campos comunes (y, opcionalmente, eventos asociados) en una clase base para hacer referencia a los controles declarados en un control de usuario. Debido al modelo de generación de código de ASP.NET, si se definen los campos de una clase base sin utilizar este atributo, en tiempo de compilación se generarán nuevas definiciones de miembros para los controles declarados en el control de usuario (dentro del código auxiliar de clase parcial independiente) y el escenario que desea no funcionará. Sin embargo, si utiliza el atributo CodeFileBaseClass para asociar la clase base al control de usuario y hace que la clase parcial herede de la clase base (su nombre se asigna al atributo Inherits y el atributo CodeFile hace referencia a su archivo de código fuente), los campos de la clase base podrán hacer referencia a los controles del control de usuario después de la generación del código.

  • CompilationMode
    Establece si se debería compilar el control, utilizando una cadena que especifica una de varias opciones enumeradas. El valor predeterminado es Always, por lo que los controles .aspx se compilan de forma predeterminada. Para obtener información detallada, vea la enumeración CompilationMode.

  • CompilerOptions
    Cadena que contiene las opciones del compilador que se utilizan para compilar el control. 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, vea Opciones del compilador de C# o Compilador de Visual Basic.

  • Debug
    Indica si el control se debe compilar con símbolos de depuración. Es true si el control debe compilarse con símbolos de depuración; de lo contrario, es false. Dado que este valor afecta al rendimiento, debería establecer el atributo en true sólo durante el desarrollo.

  • Description
    Proporciona texto que describe el control. El analizador de ASP.NET no tiene en cuenta este valor.

  • EnableTheming
    Indica si se utilizan temas en el control. Es true si se utilizan temas; de lo contrario, es false. El valor predeterminado es true.

  • EnableViewState
    Indica si se mantiene el estado de vista entre solicitudes de control. Es true si se mantiene el estado de vista; de lo contrario, es false. El valor predeterminado es true.

  • Explicit
    Determina si el control se ha compilado con el modo Option Explicit de Visual Basic. true indica que la opción de compilación explícita de Visual Basic está habilitada y que todas las variables deben declararse con una instrucción Dim, Private, Public o ReDim; en caso contrario, es false. El valor predeterminado es false.

    Nota

    Los lenguajes que no son Visual Basic no tienen en cuenta este atributo. Asimismo, esta opción se establece en true en el archivo de configuración Machine.config. Para obtener más información, vea Archivos de configuración del equipo.

  • Inherits
    Define una clase de código subyacente que el control hereda. Puede ser cualquier clase derivada de la clase UserControl. Se utiliza con el atributo CodeFile, que contiene la ruta de acceso al archivo de código fuente para la clase de código subyacente. Para obtener más información sobre las clases de código subyacente, vea Modelo de código de las páginas web ASP.NET.

  • Language
    Especifica el lenguaje utilizado al compilar todos los bloques de representación en línea (<% %> y <%= %>) y de declaraciones de código dentro del control. Los valores pueden representar cualquier lenguaje compatible con .NET Framework, incluidos Visual Basic, C# o JScript. Sólo se puede utilizar y especificar un lenguaje por control.

  • LinePragmas
    Determina si el motor en tiempo de ejecución debe generar pragmas de línea en el código fuente. Éstas son opciones del compilador que las herramientas de depuración suelen utilizar para marcar ubicaciones específicas en un archivo de código fuente. Es true si deben generarse pragmas de línea; en caso contrario, es false.

  • Src
    Especifica una ruta de acceso a un archivo de código fuente que contiene código que se vincula al control. En el archivo de código fuente vinculado, puede decidir incluir la lógica de programación del control en una clase o en bloques de declaraciones de código.

    Puede utilizar el atributo Src para vincular proveedores de generación al control. Para obtener más información, vea la clase BuildProvider. Asimismo, en las versiones de ASP.NET anteriores a la versión 2.0, el atributo Src se utilizaba como alternativa a vincular un archivo de código subyacente a un control. En ASP.NET 2.0, el método preferido para vincular un archivo de código fuente subyacente a un control es utilizar el atributo Inherits para especificar una clase y el atributo CodeFile para especificar la ruta de acceso al archivo de código fuente de la clase.

  • Strict
    Indica que el control se debería compilar utilizando el modo OptionStrict de Visual Basic. Es true si se habilita Option Strict; de lo contrario, es false. El valor predeterminado es false.

    Nota

    Los lenguajes que no son Visual Basic no tienen en cuenta este atributo.

  • TargetSchema
    Especifica el nombre de un esquema que valida el contenido del control. Su finalidad es meramente descriptiva, ya que, en realidad, no se realiza ninguna validación y el analizador omite el atributo.

  • WarningLevel
    Indica el nivel de advertencia del compilador según el cual las advertencias se tratan como errores, anulando así la compilación del control. 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 se puede utilizar en controles de usuario. Los controles de usuario se definen en los archivos con la extensión .ascx. Sólo se puede incluir una directiva @ Control por cada archivo .ascx. Además, sólo se puede definir un atributo Language por cada directiva @ Control, porque sólo se puede utilizar un lenguaje por control.

Nota

La directiva @ Control tiene varios atributos en común con otras directivas que se aplican a un archivo de código fuente completo, como la directiva @ Page (utilizada en los archivos .aspx para las páginas Web) y la directiva @ Master (utilizada en los archivos .master para las páginas principales).

Si desea definir varios atributos para la directiva @ Control, separe cada par de atributo y valor con un espacio. Para un atributo concreto, no incluya un espacio a cada lado del signo igual (=) que conecta el atributo con su valor. Para obtener un ejemplo, vea la sección Ejemplo de este tema.

Ejemplo

En el siguiente ejemplo de código se indica al compilador de páginas de ASP.NET que utilice Visual Basic como lenguaje de código en línea y se deshabilita la opción que guarda el estado de vista entre solicitudes HTTP mediante el atributo EnableViewState.

<%@ Control Language="VB" EnableViewState="false" %>

Vea también

Referencia

Sintaxis de directivas

@ Page

Otros recursos

Sintaxis de páginas de ASP.NET

Controles de usuario ASP.NET