WebPartZone.ZoneTemplate プロパティ

.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

C#

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

C++

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

J#

/** @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>

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartZone クラス
WebPartZone メンバ
System.Web.UI.WebControls.WebParts 名前空間
ITemplate
その他の技術情報
Web パーツのパーソナル化の概要
ASP.NET Web パーツ ページ