MasterPage.Master Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera nadrzędną stronę wzorcową bieżącego wzorca w scenariuszach zagnieżdżonych stron wzorcowych.
public:
property System::Web::UI::MasterPage ^ Master { System::Web::UI::MasterPage ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.MasterPage Master { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Master : System.Web.UI.MasterPage
Public ReadOnly Property Master As MasterPage
Wartość właściwości
Strona wzorcowa, która jest elementem nadrzędnym bieżącej strony wzorcowej; w przeciwnym razie , null
jeśli bieżąca strona wzorcowa nie ma elementu nadrzędnego.
- Atrybuty
Przykłady
Ta sekcja zawiera trzy przykłady kodu. Pierwszy przykład kodu przedstawia sposób tworzenia zagnieżdżonej strony.
wzorcowej Drugi przykład kodu pokazuje, jak odwoływać się do strony wzorcowej utworzonej w pierwszym przykładzie kodu. Trzeci przykład kodu pokazuje, jak za pomocą strony zawartości odwoływać się do strony wzorcowej utworzonej w drugim przykładzie kodu.
Poniższy przykład kodu przedstawia sposób tworzenia zagnieżdżonej strony wzorcowej i reprezentuje nadrzędną stronę wzorcową o nazwie ParentMasterPage_1
.
<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>Nested Master Page Example</title>
</head>
<body>
<form id="form1" runat="server">
<h1>This is content in the parent master page.</h1>
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>Nested Master Page Example</title>
</head>
<body>
<form id="form1" runat="server">
<h1>This is content in the parent master page.</h1>
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
Poniższy przykład kodu przedstawia sposób użycia zagnieżdżonej strony wzorcowej o nazwie ChildMasterPage_1
odwołującej się do strony wzorcowej utworzonej w poprzednim przykładzie kodu.
<%@ Master Language="C#" MasterPageFile="~/ParentMasterPage_1cs.master" %>
<asp:Content Runat="Server" ContentPlaceHolderID="ContentPlaceHolder1">
<h2>This is the content of a nested Master Page.</h2>
<div>
<asp:contentplaceholder id="ContentPlaceHolder2" runat="server">
</asp:contentplaceholder>
</div>
</asp:Content>
<%@ Master Language="VB" MasterPageFile="~/ParentMasterPage_1vb.master" %>
<asp:Content Runat="Server" ContentPlaceHolderID="ContentPlaceHolder1">
<h2>This is the content of a nested Master Page.</h2>
<div>
<asp:contentplaceholder id="ContentPlaceHolder2" runat="server">
</asp:contentplaceholder>
</div>
</asp:Content>
W poniższym przykładzie kodu pokazano, jak używać strony zawartości o nazwie ContentPage
, która odwołuje ChildMasterPage_1
się do utworzonego w poprzednim przykładzie kodu.
<%@ Page Language="C#" MasterPageFile="~/ChildMasterPage_1cs.master" Title="Untitled Page"%>
<asp:content runat="server" contentplaceholderid="ContentPlaceHolder2">
This is the content of a Content control.
</asp:content>
<%@ Page Language="VB" MasterPageFile="~/ChildMasterPage_1vb.master" Title="Untitled Page"%>
<asp:content runat="server" contentplaceholderid="ContentPlaceHolder2">
This is the content of a Content control.
</asp:content>
Uwagi
Właściwość Master jest tylko do odczytu, ponieważ nie można skompilować hierarchii stron wzorcowych w czasie wykonywania.