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 参照します。 テンプレートには、コントロール、ユーザー コントロール、カスタム コントロール、ASP.NET コントロールなどWebPart、コントロール内でWebPartZone宣言できる静的サーバー コントロールが含まれています。

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

こちらもご覧ください

• ITemplate
• Web パーツのパーソナル化の概要
• ASP.NET Web パーツ コントロール