MasterPage.MasterPageFile Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

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, set

Public Property MasterPageFile As String

Eigenschaftswert

String

Der Name der Masterseite, die der aktuellen Masterseite übergeordnet ist, andernfalls null, wenn der aktuellen Masterseite keine Seite übergeordnet ist.

Ausnahmen

InvalidOperationException

Die MasterPageFile-Eigenschaft kann nur während des PreInit-Ereignisses oder davor festgelegt werden.

Beispiele

Dieser Abschnitt enthält drei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie eine geschachtelte master Seite. erstellt wird. Im zweiten Codebeispiel wird veranschaulicht, wie auf die im ersten Codebeispiel erstellte master Seite verwiesen wird. Das dritte Codebeispiel veranschaulicht, wie eine Inhaltsseite verwendet wird, um auf die master Seite zu verweisen, die im zweiten Codebeispiel erstellt wurde.

Im folgenden Codebeispiel wird veranschaulicht, wie eine geschachtelte master Seite erstellt wird, und stellt die übergeordnete master Seite namens ParentMasterPage_1dar.

<%@ 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 master Seite namens ChildMasterPage_1 verwendet wird, die auf die im vorherigen Codebeispiel erstellte master Seite verweist.

<%@ 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>

Gilt für:

Weitere Informationen

Geschachtelte Gestaltungsvorlagen