MasterPage.MasterPageFile Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název stránky předlohy, která obsahuje aktuální obsah.

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

Hodnota vlastnosti

String

Název stránky předlohy, která je nadřazenou stránkou aktuální předlohy; v opačném případě , nullpokud aktuální stránka předlohy nemá žádný nadřazený objekt.

Výjimky

InvalidOperationException

Vlastnost MasterPageFile lze nastavit pouze v události nebo před událostí PreInit .

Příklady

Tato část obsahuje tři příklady kódu. První příklad kódu ukazuje, jak vytvořit vnořenou stránku. předlohy. Druhý příklad kódu ukazuje, jak odkazovat na stránku předlohy, která byla vytvořena v prvním příkladu kódu. Třetí příklad kódu ukazuje, jak pomocí stránky obsahu odkazovat na stránku předlohy, která byla vytvořena v druhém příkladu kódu.

Následující příklad kódu ukazuje, jak vytvořit vnořenou stránku předlohy a představuje nadřazenou stránku předlohy s názvem 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>

Následující příklad kódu ukazuje, jak použít vnořenou stránku předlohy s názvem ChildMasterPage_1 , která odkazuje na stránku předlohy, která byla vytvořena v předchozím příkladu kódu.

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

Následující příklad kódu ukazuje, jak použít stránku obsahu s názvem ContentPage , která odkazuje na ChildMasterPage_1 vytvořený v předchozím příkladu kódu.

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

Platí pro

Viz také

Vnořené stránky předlohy