Las directivas ASP.NET son instrucciones para especificar configuraciones opcionales, como registrar un control personalizado y el idioma de la página. Esta configuración describe cómo NET Framework maneja páginas web de formulario de una sola página (.aspx) o de control de usuario (.ascx).
Sintaxis básica para emitir comandos:
<%@ directive_name attribute=value [attribute=value] %>En esta sección, presentaremos las directivas ASP.NET, la mayoría de las cuales se utilizarán a lo largo del tutorial.
Las directivas de aplicación definen propiedades específicas de la aplicación. Se proporciona en la parte superior del archivo global.aspx.
Sintaxis básica de las instrucciones de la aplicación:
<%@ Application Language="C#" %>Propiedades de la directiva de aplicación:
| propiedad | describir |
|---|---|
| hereda | Heredado del nombre de la clase. |
| Descripción | Una descripción de texto de la aplicación. El analizador y el compilador ignoran esto. |
| Idioma | El idioma utilizado en el grupo de códigos. |
Las directivas de colección vinculan componentes a una página web o aplicación durante el análisis. Esto puede ocurrir en todo el vínculo del tipo de aplicación en un archivo Global.asax, en un archivo de página, en un control de usuario que vincula a otra página web o en un control de usuario.
La sintaxis básica de un control de colección es:
<%@ Assembly Name ="myassembly" %>Las propiedades del control de colección son:
| propiedad | describir |
|---|---|
| Nombre | El nombre del componente de colección vinculado. |
| Src | La ruta a la que se vinculan y editan dinámicamente los archivos de origen. |
Las instrucciones de control se utilizan con los controles de usuario y aparecen en archivos de control de usuario (.ascx).
La sintaxis básica de las instrucciones de control es:
<%@ Control Language="C#" EnableViewState="false" %>Las propiedades de las instrucciones de control son:
| propiedad | describir |
|---|---|
| Conexión automática de eventos | Valor booleano que permite o deshabilita la asociación automática de controladores de eventos. |
| Nombre de clase | El nombre del archivo del control. |
| Depurar | Valor booleano que permite o deshabilita la edición de símbolos de depuración. |
| Descripción | Descripción de texto de la página de control, ignorada por el compilador. |
| Habilitar estado de vista | La solicitud de página es un valor booleano que indica si se debe mantener el estado de vista. |
| Explícito | En lenguaje VB, le dice al editor que use el modo de visualización de opciones. |
| hereda | Controla la clase heredada por la página. |
| Idioma | Lenguajes de codificación y scripting. |
| Src | El nombre de archivo de la clase de código subyacente. |
| Estricto | En el lenguaje VB, le dice al editor que use la opción Modo Estándar. |
Las directivas de herramientas indican que una página web, una página maestra o una página de control de usuario deben implementar una interfaz .Net Framework específica.
La sintaxis básica de las instrucciones de la herramienta es:
<%@ Implements Interface="interface_name" %>La directiva de importación importa un espacio de nombres a una página de una aplicación controlada por el usuario. Si la directiva Importar se especifica en el archivo global.asax, se aplica a toda la aplicación. Si está en una página web dentro de una página controlada por el usuario, se aplicará a esa página web o control.
La sintaxis básica de la directiva de importación es:
<%@ namespace="System.Drawing" %>La directiva principal especifica un archivo de página como página de inicio.
La sintaxis básica de la directiva de página de inicio de ejemplo es:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>La directiva MasterType asigna un nombre de clase al atributo maestro de la página, reforzando su tipo.
La sintaxis básica de la directiva maestra es:
<%@ MasterType attribute="value"[attribute="value" ...] %>La directiva de almacenamiento en caché de resultados controla la política de almacenamiento en caché de resultados de una página web o control de usuario.
Sintaxis básica para instrucciones de almacenamiento en caché de salida:
<%@ OutputCache Duration="15" VaryByParam="None" %>Las directivas de página definen atributos de archivos de página para analizadores y compiladores de páginas específicos.
La sintaxis básica de la directiva de página es:
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>Las propiedades de la directiva de página son:
| propiedad | describir |
|---|---|
| Conexión automática de eventos | Valor booleano que permite o deshabilita la vinculación automática de eventos de página a métodos, por ejemplo, Page_Load. |
| Buffer | Valor booleano que permite o deshabilita el almacenamiento en búfer de respuesta HTTP. |
| Nombre de clase | El nombre de la categoría de la página. |
| Objetivo del cliente | El control del servidor debe mostrar el contenido al navegador. |
| Archivo de código | El nombre del archivo de código subyacente. |
| Depurar | Valor booleano que permite o deshabilita la compilación con símbolos de depuración. |
| Descripción | La descripción del archivo de la página, ignorada por el analizador. |
| Habilitar estado de sesión | Habilita o deshabilita el estado de la sesión de la página como de solo lectura. |
| Habilitar estado de vista | Un valor booleano que permite o no permite solicitudes de estado de visualización entre páginas. |
| Página de error | Dirección de redireccionamiento en caso de excepción de página no controlada. |
| hereda | El nombre del código subyacente u otra clase. |
| Idioma | Lenguaje de programación de código. |
| Src | El nombre de archivo de la clase de código subyacente. |
| Rastro | Activa o desactiva el seguimiento. |
| Modo de seguimiento | Indica cómo se muestra y clasifica la información de seguimiento por tiempo o categoría. |
| Transacción | Indica si la transacción es compatible. |
| ValidarSolicitud | Un valor booleano que indica si todos los datos de entrada se verifican válidamente como una lista codificada. |
La directiva de página anterior asigna una categoría a una página, lo que hace que se mejore ese tipo de página.
Sintaxis básica para un ejemplo de la directiva de página anterior:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>La directiva de referencia indica que se debe compilar otra página o control de usuario y vincularlo a la página actual.
La sintaxis básica de la directiva de referencia es:
<%@ Reference Page ="somepage.aspx" %>La directiva de registro se utiliza para registrar controles de servidor personalizados y controles de usuario.
La sintaxis básica de la directiva de registro es:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>