Freigeben über

MasterPage.MasterPageFile Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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. 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>

Gilt für:

Weitere Informationen