EditorZone.ZoneTemplate プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

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

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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))]
[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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))>]
[<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 ゾーン テンプレート。

属性
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

例

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

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

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

<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 が表示されたら、 要素内で宣言されている複数 EditorPart のコントロールを <zonetemplate> 確認できます。

注釈

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

注意

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

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

適用対象

こちらもご覧ください