MasterPage.MasterPageFile Propriedade

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Obtém ou define o nome da página-mestre 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 de Propriedade

String

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

Exceções

InvalidOperationException

A MasterPageFile propriedade só pode ser definida durante ou antes do PreInit evento.

Exemplos

Esta secção contém três exemplos de código. O primeiro exemplo de código demonstra como criar uma página-mestre. aninhada. O segundo exemplo de código demonstra como referenciar a página-mestre criada no primeiro exemplo de código. O terceiro exemplo de código demonstra como usar uma página de conteúdo para referenciar a página-mestre criada no segundo exemplo de código.

O seguinte exemplo de código demonstra como criar uma página-mestre aninhada e representa a página-mestre 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 seguinte demonstra como usar uma página-mestre aninhada chamada ChildMasterPage_1 que faz referência à página-mestre 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 seguinte demonstra como usar uma página de conteúdo nomeada 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

Ver também