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.
Dient zum Abrufen oder Festlegen des Namens der Gestaltungsvorlage, die den aktuellen Inhalt enthält.
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 Gestaltungsvorlage, die das übergeordnete Element der aktuellen Gestaltungsvorlage ist; andernfalls , nullwenn die aktuelle Gestaltungsvorlage kein übergeordnetes Element aufweist.
Ausnahmen
Die MasterPageFile Eigenschaft kann nur in oder vor dem PreInit Ereignis festgelegt werden.
Beispiele
Dieser Abschnitt enthält drei Codebeispiele. Im ersten Codebeispiel wird das Erstellen einer geschachtelten Gestaltungsvorlage. veranschaulicht. Im zweiten Codebeispiel wird 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 sie eine geschachtelte Gestaltungsvorlage erstellen und die übergeordnete Gestaltungsvorlage mit dem Namen ParentMasterPage_1darstellt.
<%@ 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 die Verwendung einer geschachtelten Gestaltungsvorlage veranschaulicht ChildMasterPage_1 , 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>
Das folgende Codebeispiel veranschaulicht die Verwendung einer Inhaltsseite mit dem Namen ContentPage , die auf das ChildMasterPage_1 im vorherigen Codebeispiel erstellte Objekt verweist.
<%@ 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>
