@ Master
Actualización: noviembre 2007
Define los atributos específicos de página principal (archivo .master) que utilizan el analizador y el compilador de páginas ASP.NET.
<%@ Master attribute="value" [attribute="value"...] %>
Atributos
Término |
Definición |
|---|---|
AutoEventWireup |
Indica si se pueden definir controladores de eventos simples para fases específicas del ciclo de vida mediante la sintaxis Page sin un enlace o firma de evento explícitos. Es true si la conexión automática de eventos está habilitada; de lo 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 |
Especifica el nombre de la clase que se genera automáticamente a partir del formato y se compila al procesar la página principal. Este valor puede ser cualquier nombre de clase válido 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 código específico de la página principal. Para obtener más información, vea Modelo de código de las páginas web ASP.NET. |
CompilationMode |
Especifica si una página principal ASP.NET se va a compilar en tiempo de ejecución. Las opciones son: Always para compilar siempre la página; Auto si ASP.NET debe evitar la compilación de la página cuando sea posible; y Never para no compilar nunca la página o el control. El valor predeterminado es Always. |
CompilerOptions |
Proporciona una cadena que contiene opciones del compilador para compilar la página. En C# y Microsoft Visual Basic, se trata de una secuencia de modificadores de línea de comandos del compilador. |
Debug |
Indica si la página principal se compilará con símbolos de depuración. Es true para compilar con símbolos de depuración; de lo contrario es false. |
Description |
Proporciona una descripción de la página principal. El analizador de ASP.NET no tiene en cuenta este valor. |
EnableTheming |
Indica si se puede modificar la apariencia de la página principal y sus controles cuando se aplique un tema. Es true si se puede aplicar un tema; de lo contrario es false. El valor predeterminado es true. Establecer el atributo EnableTheming es principalmente útil cuando se define un tema de página en el archivo Web.config y se aplica a todas las páginas de forma predeterminada. Para obtener más información, vea Información general sobre temas y máscaras de ASP.NET. |
EnableViewState |
Indica si el estado de vista se mantiene entre las solicitudes de la página. Es true para mantener el estado de vista; de lo contrario es false. El valor predeterminado es true. |
Explicit |
Determina si la página se ha compilado mediante 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, false. El valor predeterminado es false. .gif "Nota") Nota:
Los lenguajes que no son Visual Basic no tienen en cuenta el atributo Explicit.
El atributo Explicit se establece en true en el archivo Machine.config. Para obtener más información, vea Archivos de configuración del equipo. |
Inherits |
Especifica la clase de código subyacente que la página hereda. Puede ser cualquier clase derivada de la clase MasterPage. Para obtener información sobre las clases de código subyacente, vea Información general sobre clases de páginas ASP.NET. |
Language |
Especifica el lenguaje utilizado cuando se compilan todos los bloques de representación en línea (<% %> y <%= %>) y de declaración de código dentro de la página. Los valores pueden representar cualquier lenguaje admitido por .NET Framework, incluso VB (Visual Basic), C# y JScript. |
LinePragmas |
Determina si se deben generar pragmas en el código generado en tiempo de ejecución. |
MasterPageFile |
Especifica el archivo .master que actúa como página principal para una página principal. El atributo MasterPageFile se utiliza en una página principal al definir una página principal secundaria en un escenario de varias páginas anidadas. Para obtener información detallada, vea Páginas principales ASP.NET anidadas. |
Src |
Especifica el nombre del archivo de código fuente de la clase de código subyacente que se compilará dinámicamente cuando se solicite la página. La lógica de programación de la página se puede incluir en una clase de código subyacente o en Bloques de declaraciones de código del archivo .aspx. |
Strict |
Especifica si la página se compilará utilizando el modo Option Strict 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 el atributo Strict.
|
WarningLevel |
Especifica el nivel de advertencia del compilador en el que se anula la compilación de la página. Los valores posibles van de 0 a 4. Para obtener más información, vea WarningLevel. |
Comentarios
La directiva @ Master sólo se puede utilizar en páginas principales. Las páginas principales se definen en archivos con la extensión .master. Sólo se puede incluir una directiva @ Master por cada archivo .master.
Ejemplo
En el ejemplo de código siguiente se muestra cómo indicar al compilador de páginas ASP.NET que utilice Visual Basic como lenguaje de código en línea. El código de control de eventos se define en una clase parcial denominada MasterPageSample. El código para la clase MasterPageSample se puede encontrar en el archivo MasterPageSample.master.vb.
<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>