DIRECTIVAS Cuando se utilizan directivas, se pueden localizar en cualquier parte de un archivo .aspx o .
ascx, aunque el mtodo estndar es incluirlas al principio del archivo. Cada directiva puede contener uno o varios atributos (emparejados con valores), que son especficos de esa directiva. El marco de pginas [Link] admite las siguientes directivas. @ Page Define los atributos especficos de pgina que utilizan el analizador y el compilador de pginas de [Link]. Slo se puede incluir en archivos .aspx. Esta directiva slo se puede utilizar en pginas de formularios Web Forms. Se puede incluir slo una directiva @ Page por cada archivo .aspx. Adems, se puede definir slo un atributo Language por directiva @ Page porque se puede utilizar slo un lenguaje por pgina. Dado que se proporcionan los valores predeterminados ms comunes para la mayora de los atributos, ya sea en cdigo fuente o en archivos de configuracin, a menudo resulta necesario agregar un amplio conjunto de atributos a la directiva. Generalmente, se debe agregar el conjunto mnimo de atributos requeridos para especificar las caractersticas deseadas de una pgina. Si hay un atributo comn que desee aplicar a todas las pginas, por ejemplo, si desea habilitar el seguimiento en todas las pginas, considere la posibilidad de habilitar la caracterstica en el archivo [Link] en lugar de agregar el atributo Trace a cada pgina. @ Control Define los atributos especficos de control que utilizan el analizador y el compilador de pginas de [Link]. Slo se puede incluir en archivos .ascx (controles de usuario). Esta directiva slo se puede utilizar en controles de usuario. Los controles de usuario se definen en los archivos con la extensin .ascx. Slo se puede incluir una directiva @ Control por cada archivo .ascx. Adems, slo se puede definir un atributo Language por cada directiva @ Control, porque slo se puede utilizar un lenguaje por control. 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.
@ Import Importa explcitamente un espacio de nombres en una pgina o un control de usuario. La directiva @ Import no puede tener ms de un atributo namespace. Para importar varios espacios de nombres, se utilizan varias directivas @ Import. Los siguientes espacios de nombres se importan automticamente en todas en las pginas:
System [Link] [Link] [Link] [Link] [Link] [Link]
@ Implements Indica de forma declarativa que en una pgina o control de usuario se implementa la interfaz de .NET Framework especificada. Cuando se implementa una interfaz en una pgina de formularios Web Forms, se pueden crear sus eventos, mtodos y propiedades entre las etiquetas de apertura y de cierre de un elemento <script> en un bloque de declaraciones de cdigo. Esta directiva no se puede utilizar para implementar una interfaz en un archivo de cdigo en segundo plano. @ Register Asocia alias con espacios de nombres y nombres de clases, de ese modo permite representar los controles de usuario y los controles de servidor personalizados incluidos en la pgina o control de usuario solicitados. Utilice la directiva @ Register en las siguientes situaciones:
Para agregar mediante declaracin un control de servidor personalizado a una pgina Web, un control de usuario, una pgina principal o un archivo de mscara. Para agregar mediante declaracin un control de usuario a una pgina Web, un control de usuario, una pgina principal o un archivo de mscara.
@ Assembly Vincula un ensamblado a la pgina actual durante la compilacin y, de este modo, permite utilizar todas las clases e interfaces del ensamblado en la pgina. El compilador hace referencia al ensamblado en tiempo de compilacin para permitir el enlace en tiempo de compilacin. Una vez realizada la compilacin del archivo [Link] solicitado, se carga el ensamblado en el dominio de aplicacin para permitir el enlace en tiempo de ejecucin. La directiva @ Assembly puede usarse en pginas .aspx, archivos .ascx, pginas .master y archivos .asax. Los ensamblados que residen en el directorio \Bin de una aplicacin Web se vinculan automticamente a los archivos [Link] de dicha aplicacin. Esos ensamblados no requieren la directiva @ Assembly. Es posible deshabilitar esta funcionalidad quitando la siguiente lnea de la seccin <assemblies> del archivo [Link] de la aplicacin: <add assembly="*"/> @ Master Identifica una pgina principal de [Link]. Atributos Trmino
Definicin
AutoEventWireup Indica si se pueden definir controladores de eventos simples para fases especficas del ciclo de vida mediante la sintaxis Page sin un enlace o firma de evento explcitos. Es true si la conexin automtica de eventos est habilitada; de lo contrario es false. El valor predeterminado es true. ClassName Especifica el nombre de la clase que se genera
automticamente a partir del formato y se compila al procesar la pgina principal. Este valor puede ser cualquier nombre de clase vlido y puede incluir un espacio de nombres. CodeFile Especifica el nombre de un archivo independiente que contiene una clase parcial con los controladores de eventos y otro cdigo especfico de la pgina principal. CompilationMode Especifica si una pgina principal [Link] se va a compilar
en tiempo de ejecucin. Las opciones son: Always para compilar siempre la pgina; Auto si [Link] debe evitar la compilacin de la pgina cuando sea posible; y Never para no compilar nunca la pgina o el control. El valor predeterminado es Always.
La directiva @ Master slo se puede utilizar en pginas principales. Las pginas principales se definen en archivos con la extensin .master. Slo se puede incluir una directiva @ Master por cada archivo .master. @ PreviousPageType Proporciona los medios para el establecimiento inflexible de tipos con respecto a la pgina anterior, a la que se tiene acceso a travs de la propiedad PreviousPage. @ MasterType Asigna un nombre de clase a la propiedad Master de una pgina [Link], para que la pgina pueda obtener referencias con establecimiento inflexible de tipos a los miembros de la pgina principal. Proporciona un medio de crear una referencia con establecimiento inflexible de tipos a la pgina principal de [Link] cuando la propiedad Master tiene acceso a la pgina principal. Copiar<%@ MasterType attribute="value" [attribute="value"...] %> Atributos TypeName Especifica el nombre de tipo de la pgina principal. VirtualPath Especifica la ruta de acceso al archivo que genera el tipo seguro Ejemplo En el ejemplo de cdigo siguiente se muestra cmo establecer la ruta de acceso virtual a una pgina principal de [Link]. Copiar<%@ MasterType VirtualPath="~/masters/[Link]" %>
@ OutputCache Controla de forma declarativa las directivas de almacenamiento en la cach de resultados de una pgina o control de usuario. Establecer valores para la cach de resultados de la pgina es igual que manipular los mtodos SetExpires y SetCacheability a travs de la propiedad Cache. Si para ver una pgina de formularios Web Forms se requiere autorizacin, la cach de resultados establece el valor del encabezado HTTP Cache-Control en private. Si se establece el atributo Shared en true, varias pginas de formularios Web Forms pueden obtener acceso a los resultados del control de usuario almacenados en cach. Si no se establece en true, el comportamiento predeterminado es almacenar en la cach una versin del resultado del control de usuario para cada pgina que contenga ese control de usuario. Habilitar el atributo Shared puede ahorrar una gran cantidad de memoria
@ Reference Vincula de forma declarativa una pgina o control de usuario a la pgina o control de usuario actuales. [Link] trata cualquier bloque de directivas (<%@ %>) que no contiene un nombre de directiva explcito como directiva @ Page para una pgina, o una directiva @ Control para un control de usuario.