@ Master

更新：2007 年 11 月

定义 ASP.NET 页分析器和编译器使用的特定于母版页（.master 文件）的属性。

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

属性

术语	定义
AutoEventWireup	指示是否可以使用语法 Page 且不使用任何显式挂钩或事件签名，为特定的生命周期阶段定义简单的事件处理程序。如果启用了事件自动连接，则为 true；否则为 false。默认值为 true。有关更多信息，请参见 ASP.NET Web 服务器控件事件模型。
ClassName	指定自动从标记生成并在处理母版页时自动进行编译的类的类名。此值可以是任何有效的类名，并且可以包括命名空间。
CodeFile	指定包含分部类的单独文件的名称，该分部类具有事件处理程序和特定于母版页的其他代码。有关更多信息，请参见 ASP.NET 网页代码模型。
CompilationMode	指定是否在运行时编译 ASP.NET 母版页。选项包括：Always，表示始终编译页；Auto，在 ASP.NET 要避免编译页（如有可能）的情况下使用；Never，表示永远不编译页或控件。默认值为 Always。
CompilerOptions	提供包含用于编译页的编译器选项的字符串。在 C# 和 Microsoft Visual Basic 中，这是编译器命令行开关的序列。
Debug	指示是否使用调试符号来编译母版页。如果要使用调试符号进行编译，则为 true；否则为 false。
Description	提供母版页的文本说明。ASP.NET 分析器忽略该值。
EnableTheming	指示在应用主题时是否可以修改母版页的外观和母版页上控件的外观。如果可以应用主题，则为 true；否则为 false。默认值为 true。设置 EnableTheming 属性主要用于以下情况：默认情况下在 Web.config 文件中定义了页主题，并且将该页主题应用于所有页。有关更多信息，请参见 ASP.NET 主题和外观概述。
EnableViewState	指示是否在页请求之间保持视图状态。如果要保持视图状态，则为 true；否则为 false。默认值为 true。
Explicit	确定是否使用 Visual Basic Option Explicit 模式来编译页。如果启用了 Visual Basic 显式编译选项，且所有变量必须使用 Dim、Private、Public 或 ReDim 语句来声明，则为 true；否则为 false。默认值为 false。 说明： 除了 Visual Basic，所有其他语言都忽略 Explicit 属性。 Explicit 属性在 Machine.config 文件中设置为 true。有关更多信息，请参见计算机配置文件。
Inherits	指定供页继承的代码隐藏类。它可以是从 MasterPage 类派生的任何类。有关代码隐藏类的信息，请参见 ASP.NET 页类概述。
Language	指定在对页中所有内联呈现（<% %> 和 <%= %>）和代码声明块进行编译时使用的语言。值可以表示 .NET Framework 支持的任何语言，包括 VB (Visual Basic)、C# 和 JScript。
LinePragmas	确定运行库是否应在生成的代码中生成杂注。
MasterPageFile	指定用作某个母版页的 .master 文件。定义嵌套母版页方案中的子母版页时，在母版页中使用 MasterPageFile 属性。有关详细信息，请参见嵌套的 ASP.NET 母版页。
Src	指定在请求页时动态编译的代码隐藏类的源文件名称。您可以选择将页的编程逻辑包含在代码隐藏类中或 .aspx 文件的代码声明块中。
Strict	指定是否使用 Visual Basic Option Strict 模式来编译页。如果启用了 Option Strict，则为 true；否则为 false。默认值为 false。 说明： 除了 Visual Basic，所有其他语言都忽略 Strict 属性。
WarningLevel	指定您想要编译器中止对页进行编译的编译器警告等级。可能的值为 0 到 4。有关更多信息，请参见 WarningLevel。

备注

只能在母版页中使用 @ Master 指令。母版页在带有 .master 扩展名的文件中进行定义。每个 .master 文件只能包含一条 @ Master 指令。

示例

下面的代码示例演示如何指示 ASP.NET 页编译器将 Visual Basic 用作内联代码语言。事件处理代码在名为 MasterPageSample 的分部类中定义。可以在 MasterPageSample.master.vb 文件中找到 MasterPageSample 类的代码。

<% @ Master Language="VB" CodeFile="MasterPageSample.master.vb" Inherits="MasterPageSample" %>

请参见

概念

ASP.NET 网页语法概述

ASP.NET 母版页概述