Partager via


Syntaxe déclarative des contrôles serveur Web ContentPlaceHolder

Mise à jour : novembre 2007

Créer une région pour le contenu dans une page maître ASP.NET.

<asp: ContentPlaceHolder
        EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    Visible="True|False"
>
        <!-- child controls -->
</asp:ContentPlaceHolder>

Notes

Un contrôle ContentPlaceHolder définit une région relative pour le contenu dans une page maître et rend tout le texte, le balisage et les contrôles serveur d'un contrôle Content lié trouvé dans une page de contenu.

Un contrôle Content est associé à un ContentPlaceHolder qui utilise sa propriété ContentPlaceHolderID. Affectez la valeur de la propriété ID à la propriété ContentPlaceHolderID du contrôle ContentPlaceHolder lié dans une page maître. Plusieurs ContentPlaceHolder peuvent être déclarés dans une page maître. Pour plus d'informations sur les pages maîtres, consultez Pages maîtres ASP.NET.

Exemple

L'exemple de code suivant montre comment utiliser le contrôle ContentPlaceHolder pour définir le contenu d'une région pour une page maître. La page Web est une page maître et définit une région de contenu à l'aide d'un contrôle ContentPlaceHolder. Une page de contenu fait référence à cette page maître en définissant l'attribut MasterPageFile de la directive @ Page et en définissant des contrôles Content.

<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>
<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>MasterPage Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
    </div>
    </form>
</body>
</html>

Voir aussi

Référence

ContentPlaceHolder

Autres ressources

Pages maîtres ASP.NET