@ Master

  • 项目

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

定义 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。

NoteNote
除了 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。

NoteNote
除了 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 Web Page Syntax Overview

其他资源

ASP.NET Master Pages Overview