MasterPage 类 - 爱码网

每个与母版页相关的内容页必须在其 @ Page 指令的 MasterPageFile 属性中引用母版页。内容页只能包含该 @ Page 指令和一个或多个 Content 控件。所有页文本、标记和服务器控件都必须放置在 Content 控件中。通过设置 Content 控件的 ContentPlaceHolderID 属性，可标识与 Content 控件关联的母版页的 ContentPlaceHolder 控件。

在运行时，所请求页上的每个 Content 控件的动态内容将合并到母版页上与这些控件关联的 ContentPlaceHolder 控件的确切位置。母版页中所有其他标记和控件不受影响。在母版类中和内容页上，都可存在事件处理程序。有关更多信息，请参见 ASP.NET 母版页和内容页中的事件。

MasterPage 类与扩展名为 .master 的文件相关联。这些文件在运行时被编译为 MasterPage 对象，并被缓存在服务器内存中。

通过基 Page 类的 Master 属性，内容页可以使用母版页。Master 属性返回母版页的实例；但是，它的类型为基 MasterPage 类。若要访问母版页的控件、属性和函数，Master 属性可强制转换为 MasterPage。母版页的类名用 @ Master 指令的 ClassName 属性定义。

注意
不会向浏览器提供扩展名为 .master 的文件。

母版页上的有效指令与 UserControl 对象上的可用指令相同，它们可包括以下属性：

AutoEventWireup
ClassName
CodeFile
CompilerMode
CompilerOptions
Debug
Description
EnableTheming
EnableViewState
Explicit
Inherits
Language
LinePragmas
MasterPageFile
Src
Strict
WarningLevel

母版页指令不会重写各个内容页上的指令。

母版页大部分情况下以声明方式创建。如果您希望以编程方式创建母版页，请直接从 MasterPage 类派生。除了扩展 MasterPage 类以外，您必须创建 .master 文件，从而以视觉方式显示与您在源文件中所调用类相关联的用户界面 (UI)。

注意
当您通过首先创建自己的类来创建母版页时，您必须包括该页所使用的类需要的全部命名空间。

有关母版页的更多信息，请参见 ASP.NET 母版页概述。

本节包含四个代码示例：

第一个代码示例演示如何以声明方式创建母版页。
第二个代码示例表示与第一个代码示例中所创建的母版页相关联的内容页。
第三个代码示例演示如何向母版页添加属性。
第四个代码示例演示如何使用内容页来访问母版页上的公共属性。

下面的代码示例演示如何以声明方式创建母版页，以及如何使用内容页向它添加一些内容。第一个网页是名为 MasterPageSample_1.master 的 .master 页。

复制代码

//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html  >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form >
<div>
<asp:contentplaceholder  />
</div>
</form>
</body>
</html>

Visual Basic

复制代码

 %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html  >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>

下面的代码示例表示与 MasterPageSample_1.master 相关联的内容页。它包含一个 Content 控件，并使用 ContentPlaceHolderID 属性标识与内容相关联的 ContentPlaceHolder 控件。

复制代码

Visual Basic

复制代码

%>
<asp:content
runat="server"
contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>

下面的代码示例演示如何向母版页添加属性。ClassName 属性用于为母版页命名。

复制代码

public string SiteName
{
get { return "My Site Name"; }
}
</script>
<html  >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form >
<div>
<asp:contentplaceholder >
</asp:contentplaceholder>
</div>
</form>
</body>
</html>

Visual Basic

复制代码

 %>
<script runat="server">
Public ReadOnly Property SiteName() As String
Get
Return "My Site Name"
End Get
End Property
</script>
<html  >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>

下面的代码示例演示如何使用内容页访问前一个代码示例中的母版页上的公共属性 SiteName。

复制代码

protected void Page_Load(object sender, EventArgs e)
{
MasterExample m = (MasterExample)Page.Master;
mylabel.Text = m.SiteName;
}
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

Visual Basic

复制代码

 %>
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim m As MasterExample = CType(Page.Master, MasterPage)
mylabel.Text = m.SiteName
End Sub
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>

AspNetHostingPermission 用于在宿主环境中进行操作。要求值：LinkDemand；权限值：Minimal。
AspNetHostingPermission 用于在宿主环境中进行操作。要求值：InheritanceDemand；权限值：Minimal。