通过

ContentPlaceHolder Web 服务器控件声明性语法

  • 项目

更新：2007 年 11 月

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

备注

ContentPlaceHolder 控件为母版页中的内容定义一个相对区域，并且呈现在内容页中发现的相关 Content 控件内的所有文本、标记和服务器控件。

Content 控件使用其 ContentPlaceHolderID 属性与 ContentPlaceHolder 关联。将 ContentPlaceHolderID 属性设置为母版页中相关 ContentPlaceHolder 控件的 ID 属性的值。一个母版页中可以声明多个 ContentPlaceHolder。有关母版页的更多信息，请参见 ASP.NET 母版页。

示例

下面的代码示例说明如何使用 ContentPlaceHolder 控件定义母版页的内容区域。此网页是母版页，它使用 ContentPlaceHolder 控件定义了一个内容区域。内容页通过设置 @ Page 指令的 MasterPageFile 属性并定义 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>

请参见

参考

ContentPlaceHolder

其他资源

ASP.NET 母版页