EditorZone.ZoneTemplate プロパティ

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

EditorZone.ZoneTemplate プロパティ

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

ページの永続形式で EditorZone コントロール内に子コントロールを含めるテンプレートを提供します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As EditorZone
Dim value As ITemplate

value = instance.ZoneTemplate

instance.ZoneTemplate = value

C#

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

C++

[TemplateContainerAttribute(typeof(EditorZone))] 
[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)

プロパティ値
ゾーンの子コントロールのコンテナとして機能する ITemplate ゾーン テンプレート。

解説

ZoneTemplate プロパティは、EditorZone クラスと EditorZoneBase 基本クラスとの間の重要な違いです。ゾーン テンプレートのサポートを追加することによって、EditorZone クラスでは、ページ開発者が、Web ページの宣言マークアップで EditorZone コントロール内に子 EditorPart コントロールを配置できるようになります。ゾーン テンプレートは、子コントロールのコンテナとして機能します。

メモ
ZoneTemplate プロパティの set アクセサは、InvalidateEditorParts メソッドを呼び出します。これは、テンプレートで宣言されている EditorPart コントロールのコレクションを強制的に再作成します。これにより、テンプレートの内容の変更がすべて認識されます。

ゾーン テンプレートを EditorZone コントロール内で宣言によって使用するには、<zonetemplate> タグのペアを追加し、そのタグの間の EditorPart コントロールを参照します。EditorZone コントロールのインスタンスごとにレンダリングされるゾーン テンプレートは 1 つだけです (したがって、複数の <zonetemplate> 要素を EditorZone コントロールに追加する理由はありません)。また、EditorZone コントロールのゾーン テンプレートには、EditorPart クラスから派生するパーツ コントロールだけを含めることができます。

使用例

ZoneTemplate プロパティの宣言による使用方法を示すコード例を次に示します。この例の完全なコードは、EditorZone クラスの概要にある「例」のセクションを参照してください。

コード例は、EditorPart コントロールを、EditorZone コントロールの <zonetemplate> 要素内に配置する方法を示します。

Visual Basic

<asp:EditorZone ID="EditorZone1" runat="server"
 >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1"
 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1"
 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>

C#

<asp:EditorZone ID="EditorZone1" runat="server" >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>

ブラウザでページを読み込む場合、ドロップダウン リストの [編集モード] を選択して、編集モードに切り替えることができます。編集ユーザー インターフェイス (UI) を表示するには、2 つのコントロールのいずれかのタイトル バーで動詞メニュー (下向きの矢印) をクリックし、[編集] をクリックしてコントロールを編集できます。編集 UI を表示すると、<zonetemplate> 要素内で宣言されているいくつかの EditorPart コントロールを確認できます。

プラットフォーム

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

参照

関連項目
EditorZone クラス
EditorZone メンバ
System.Web.UI.WebControls.WebParts 名前空間
ZoneTemplate
ITemplate
InvalidateEditorParts
その他の技術情報
ASP.NET Web パーツ ページ