Deklarative Syntax des ContentPlaceHolder-Webserver-Steuerelements

Aktualisiert: November 2007

Erstellt einen Inhaltsbereich auf einer ASP.NET-Masterseite.

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

Hinweise

Ein ContentPlaceHolder-Steuerelement definiert einen relativen Inhaltsbereich auf einer Masterseite und gibt sämtliche Text-, Markup- und Serversteuerelemente aus einem verknüpften Content-Steuerelement wieder, das sich auf einer Inhaltsseite befindet.

Ein Content-Steuerelement wird mithilfe der ContentPlaceHolderID-Eigenschaft einem ContentPlaceHolder zugeordnet. Legen Sie die ContentPlaceHolderID-Eigenschaft auf den Wert der ID-Eigenschaft der verknüpften ContentPlaceHolder-Eigenschaft auf einer Masterseite fest. Auf einer Masterseite können mehrere ContentPlaceHolder deklariert werden. Weitere Informationen zu Masterseiten finden Sie unter ASP.NET-Masterseiten.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein Inhaltsbereich für eine Masterseite mithilfe des ContentPlaceHolder-Steuerelements definiert wird. Die Webseite ist eine Masterseite und definiert mithilfe eines ContentPlaceHolder-Steuerelements einen Inhaltsbereich. Eine Inhaltsseite verweist auf diese Masterseite, indem das MasterPageFile-Attribut der @ Page-Direktive festgelegt und Content-Steuerelemente definiert werden.

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

Siehe auch

Referenz

ContentPlaceHolder

Weitere Ressourcen

ASP.NET-Masterseiten