MasterPage.MasterPageFile Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le nom de la page maître qui contient le contenu en cours.
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
Valeur de propriété
Nom de la page maître qui est le parent de la page maître en cours ; sinon, null
si la page maître en cours n'a aucun parent.
Exceptions
La propriété MasterPageFile peut uniquement être définie dans l'événement PreInit ou avant celui-ci.
Exemples
Cette section contient trois exemples de code. Le premier exemple de code montre comment créer une page.
maître imbriquée Le deuxième exemple de code montre comment référencer la page maître créée dans le premier exemple de code. Le troisième exemple de code montre comment utiliser une page de contenu pour référencer la page maître créée dans le deuxième exemple de code.
L’exemple de code suivant montre comment créer une page maître imbriquée et représente la page maître parente nommée 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>
L’exemple de code suivant montre comment utiliser une page maître imbriquée nommée ChildMasterPage_1
qui fait référence à la page maître créée dans l’exemple de code précédent.
<%@ 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>
L’exemple de code suivant montre comment utiliser une page de contenu nommée ContentPage
qui fait référence à qui ChildMasterPage_1
a été créé dans l’exemple de code précédent.
<%@ 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>