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宣言できる静的サーバー コントロールが含まれています。

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

適用対象

こちらもご覧ください