[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
定义 ASP.NET 页分析器和编译器使用的特定于母版页(.master 文件)的特性。
<%@ Master attribute="value" [attribute="value"...] %>
术语 |
定义 |
---|---|
AutoEventWireup |
指示是否可以使用不带任何显式挂钩或事件签名的语法 Page,为特定的生命周期阶段定义简单的事件处理程序。 如果启用了事件自动连接,则为 true;否则为 false。 默认值为 true。 有关更多信息,请参见 ASP.NET Web Server Control Event Model。 |
ClassName |
指定自动从标记生成并在处理母版页时自动进行编译的类的类名。 此值可以是任何有效的类名,并且可以包括命名空间。 |
CodeFile |
指定包含分部类的单独文件的名称,该分部类具有事件处理程序和特定于母版页的其他代码。 有关更多信息,请参见 ASP.NET Web Page Code Model。 |
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 Themes Overview。 |
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。 有关更多信息,请参见 Machine Configuration Files。 |
Inherits |
指定供页继承的代码隐藏类。 它可以是从 MasterPage 类派生的任何类。 有关代码隐藏类的信息,请参见 ASP.NET Page Class Overview。 |
Language |
指定在对页中所有内联呈现(<% %> 和 <%= %>)和代码声明块进行编译时使用的语言。 值可以表示 .NET Framework 支持的任何语言,包括 VB (Visual Basic)、C# 和 JScript。 |
LinePragmas |
确定运行时是否应在生成的代码中生成杂注。 |
MasterPageFile |
指定用作某个母版页的 .master 文件。 定义嵌套母版页方案中的子母版页时,在母版页中使用 MasterPageFile 特性。 有关详细信息,请参见Nested ASP.NET Master Pages。 |
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" %>