MasterPage.MasterPageFile Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Namen der Masterseite ab, die den aktuellen Inhalt enthält, oder legt diesen fest.
public:
property System::String ^ MasterPageFile { System::String ^ get(); void set(System::String ^ value); };public string MasterPageFile { get; set; }member this.MasterPageFile : string with get, setPublic Property MasterPageFile As StringEigenschaftswert
Der Name der Masterseite, die der aktuellen Masterseite übergeordnet ist, andernfalls null, wenn der aktuellen Masterseite keine Seite übergeordnet ist.
Ausnahmen
Die MasterPageFile-Eigenschaft kann nur während des PreInit-Ereignisses oder davor festgelegt werden.
Beispiele
Dieser Abschnitt enthält drei Codebeispiele. Das erste Codebeispiel veranschaulicht, wie eine geschachtelte Gestaltungsvorlage. erstellt wird. Das zweite Codebeispiel veranschaulicht, wie auf die Gestaltungsvorlage verwiesen wird, die im ersten Codebeispiel erstellt wurde. Im dritten Codebeispiel wird veranschaulicht, wie eine Inhaltsseite verwendet wird, um auf die Gestaltungsvorlage zu verweisen, die im zweiten Codebeispiel erstellt wurde.
Im folgenden Codebeispiel wird veranschaulicht, wie eine geschachtelte Gestaltungsvorlage erstellt wird, und stellt die übergeordnete Gestaltungsvorlage namens dar 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>
Im folgenden Codebeispiel wird veranschaulicht, wie eine geschachtelte Gestaltungsvorlage mit dem Namen ChildMasterPage_1 verwendet wird, die auf die Gestaltungsvorlage verweist, die im vorherigen Codebeispiel erstellt wurde.
<%@ 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>
Im folgenden Codebeispiel wird veranschaulicht, wie eine Inhaltsseite mit dem Namen verwendet ContentPage wird, die auf den ChildMasterPage_1 verweist, der im vorherigen Codebeispiel erstellt wurde.
<%@ 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>
