WebPartZone.ZoneTemplate プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebPartZone.ZoneTemplate プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<TemplateInstanceAttribute(TemplateInstance.Single)> _
Public Overridable Property
 ZoneTemplate As ITemplate

Visual Basic (使用法)

Dim instance As WebPartZone
Dim value As ITemplate

value = instance.ZoneTemplate

instance.ZoneTemplate = value

[TemplateInstanceAttribute(TemplateInstance.Single)] 
public virtual ITemplate ZoneTemplate { get;
 set; }

C++

[TemplateInstanceAttribute(TemplateInstance::Single)] 
public:
virtual property ITemplate^ ZoneTemplate {
    ITemplate^ get ();
    void set (ITemplate^ value);
}

/** @property */
public ITemplate get_ZoneTemplate ()

/** @property */
public void set_ZoneTemplate (ITemplate value)

JScript

public function get ZoneTemplate
 () : ITemplate

public function set ZoneTemplate
 (value : ITemplate)

プロパティ値
ゾーン内の WebPart コントロールが含まれている ITemplate。

例外

例外の種類	条件
InvalidOperationException	ゾーン内の WebPart コントロールの登録は既に完了しています。

解説

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

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

使用例

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

WebPartZone コントロールのマークアップ内には、カレンダーコントロールへの参照が含まれる <zonetemplate> 要素が存在します。さらに WebPart コントロールまたは他のサーバーコントロールをゾーンに追加する場合は、それらを <zonetemplate> タグに追加します。

Visual Basic

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