MasterPage.MasterPageFile Propriedade

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o nome da página mestra que contém o conteúdo atual.

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

Valor da propriedade

String

O nome da página mestra que é o pai da página mestra atual; caso contrário, null, se a página mestra atual não tiver nenhum pai.

Exceções

InvalidOperationException

A propriedade MasterPageFile só pode ser definida no evento PreInit ou antes dele.

Exemplos

Esta seção contém três exemplos de código. O primeiro exemplo de código demonstra como criar uma página. de master aninhada O segundo exemplo de código demonstra como referenciar a página master que foi criada no primeiro exemplo de código. O terceiro exemplo de código demonstra como usar uma página de conteúdo para fazer referência à página master que foi criada no segundo exemplo de código.

O exemplo de código a seguir demonstra como criar uma página de master aninhada e representa a página de master pai chamada 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>

O exemplo de código a seguir demonstra como usar uma página de master aninhada chamada ChildMasterPage_1 que faz referência à página master que foi criada no exemplo de código anterior.

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

O exemplo de código a seguir demonstra como usar uma página de conteúdo chamada ContentPage que faz referência ao ChildMasterPage_1 que foi criado no exemplo de código anterior.

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

Aplica-se a

Confira também

Páginas Mestras Aninhadas