Language

WebPartZone.ZoneTemplate プロパティ

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

Web ページのマークアップで宣言されたコントロールを含む ITemplate インスタンスへの参照を取得または設定します。

public:
 virtual property System::Web::UI::ITemplate ^ ZoneTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateInstance(System.Web.UI.TemplateInstance.Single)]
public virtual System.Web.UI.ITemplate ZoneTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateInstance(System.Web.UI.TemplateInstance.Single)>]
member this.ZoneTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property ZoneTemplate As ITemplate

プロパティ値

ITemplate

ゾーン内のITemplate コントロールを含むWebPart。

属性
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

例外

InvalidOperationException

ゾーン内の WebPart コントロールの登録は既に完了しています。

例

次のコード例は、Web パーツ ページの宣言型マークアップで ZoneTemplate プロパティを使用する方法を示しています。 カスタム クラスとコントロールをホストする.aspx ページなど、この例の完全なコードについては、 WebPartZone クラスの概要に関するトピックの「例」セクションを参照してください。

WebPartZone コントロールのマークアップには、Calendar コントロールへの参照を含む<zonetemplate>要素があることに注意してください。 WebPart コントロールまたはその他のサーバー コントロールをゾーンに追加する場合は、<zonetemplate> タグ内に追加することもできます。

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

注釈

ZoneTemplate プロパティは、ITemplate コントロール内のWebPartZone インスタンスを参照します。 テンプレートには、WebPartZone コントロール、ユーザー コントロール、カスタム コントロール、ASP.NET コントロールなど、WebPart コントロール内で宣言できる静的サーバー コントロールが含まれています。

静的 WebPart またはその他のサーバー コントロールを Web ページの宣言型マークアップの WebPartZone に追加する場合は、コントロールのタグを <zonetemplate> タグのペア内に配置する必要があります。 <zonetemplate>タグ内でコントロールを宣言しないと、例外がスローされます。

適用対象

こちらもご覧ください