@ Master
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Define los atributos específicos de página maestra (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. De manera predeterminada, es true. Para obtener más información, vea ASP.NET Web Server Control Event Model. |
ClassName |
Especifica el nombre de la clase que se genera automáticamente a partir del formato y se compila al procesar la página maestra. 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 maestra. Para obtener más información, vea ASP.NET Web Page Code Model. |
CompilationMode |
Especifica si una página maestra 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 maestra 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 maestra. El analizador de ASP.NET no tiene en cuenta este valor. |
EnableTheming |
Indica si se puede modificar la apariencia de la página maestra y sus controles cuando se aplique un tema. Es true si se puede aplicar un tema; de lo contrario es false. De manera predeterminada, 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 ASP.NET Themes Overview. |
EnableViewState |
Indica si el estado de vista se mantiene en todas las solicitudes de páginas. Es true para mantener el estado de vista; en caso contrario, es false. De manera predeterminada, es true. |
Explicit |
Determina si la página se compilará utilizando 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 "Note") Note
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 Machine Configuration Files. |
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 ASP.NET Page Class Overview. |
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 maestra para una página maestra. El atributo MasterPageFile se utiliza en una página maestra al definir una página maestra secundaria en un escenario de varias páginas anidadas. Para obtener información detallada, vea Nested ASP.NET Master Pages. |
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 Option Strict está habilitado; en caso contrario, es false. El valor predeterminado es false. Note
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 maestras. Las páginas maestras 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" %>
Vea también
Conceptos
ASP.NET Web Page Syntax Overview