linux-packaging-mono/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ContentPlaceHolder.xml

<?xml version="1.0" encoding="utf-8"?>
<Type Name="ContentPlaceHolder" FullName="System.Web.UI.WebControls.ContentPlaceHolder">
  <TypeSignature Language="C#" Value="public class ContentPlaceHolder : System.Web.UI.Control, System.Web.UI.INamingContainer" />
  <AssemblyInfo>
    <AssemblyName>System.Web</AssemblyName>
    <AssemblyVersion>2.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Base>
    <BaseTypeName>System.Web.UI.Control</BaseTypeName>
  </Base>
  <Interfaces>
    <Interface>
      <InterfaceName>System.Web.UI.INamingContainer</InterfaceName>
    </Interface>
  </Interfaces>
  <Attributes>
    <Attribute>
      <AttributeName>System.Web.UI.ControlBuilder(typeof(System.Web.UI.WebControls.ContentPlaceHolderBuilder))</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.Web.UI.ToolboxData("&lt;;{0}:ContentPlaceHolder runat=&amp;quot;server&amp;quot;&gt;&lt;/{0}:ContentPlaceHolder&gt;")</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.Designer("System.Web.UI.Design.WebControls.ContentPlaceHolderDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.ToolboxItemFilter("System.Web.UI", System.ComponentModel.ToolboxItemFilterType.Allow)</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.ToolboxItemFilter("Microsoft.VisualStudio.Web.WebForms.MasterPageWebFormDesigner", System.ComponentModel.ToolboxItemFilterType.Require)</AttributeName>
    </Attribute>
  </Attributes>
  <Docs>
    <since version=".NET 2.0" />
    <remarks>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>A <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> control defines a relative region for content in a master page, and renders all text, markup, and server controls from a related <see cref="T:System.Web.UI.WebControls.Content" /> control found in a content page.</para>
      <para>A <see cref="T:System.Web.UI.WebControls.Content" /> control is associated with a <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> using its <see cref="P:System.Web.UI.WebControls.Content.ContentPlaceHolderID" /> property. Set the <see cref="P:System.Web.UI.WebControls.Content.ContentPlaceHolderID" /> property to the value of the <see cref="P:System.Web.UI.Control.ID" /> property of the related <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> control in a master page. More than one <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> can be declared in a master page. </para>
      <para>Within a content page, only one <see cref="T:System.Web.UI.WebControls.Content" /> control can supply the content for a <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> in the master page. However, in each content page that uses a master page, you can have separate <see cref="T:System.Web.UI.WebControls.Content" /> controls associated with the <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" />. For example, you can define the <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> for the page title in a master page. For each content page that uses the master page, you can add a <see cref="T:System.Web.UI.WebControls.Content" /> control that supplies the text and markup for the page title. </para>
      <block subset="none" type="note">
        <para>For XHTML compliance, an empty title element is created if a title has not been defined or cannot be found.</para>
      </block>
      <para>You can specify default content placed within the <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> control tags, but this content is replaced by any content in an associated content page. </para>
      <para>For more information about master pages and content pages, see <format type="text/html"><a href="0852291d-6f62-4e9f-a809-45cc81e78d6b">ASP.NET Master Pages</a></format>.</para>
      <format type="text/html">
        <a href="#DeclarativeSyntax" />
      </format>
      <format type="text/html">
        <h2>Declarative Syntax</h2>
      </format>
      <code>&lt;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="<codeFeaturedElement>True</codeFeaturedElement>|False"
&gt;
        &lt;!-- child controls --&gt;
&lt;/asp:ContentPlaceHolder&gt;</code>
    </remarks>
    <summary>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>Defines a region for content in an ASP.NET master page.</para>
    </summary>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public ContentPlaceHolder ();" />
      <MemberType>Constructor</MemberType>
      <Parameters />
      <Docs>
        <remarks>To be added.</remarks>
        <since version=".NET 2.0" />
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.ContentPlaceHolder" /> class. </para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
  </Members>
</Type>