次の方法で共有


EditorZone.ZoneTemplate プロパティ

定義

ページ永続化形式の 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 ゾーン テンプレート。

属性

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

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

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

注釈

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

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

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

適用対象

こちらもご覧ください