EditorZone.ZoneTemplate プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ページの永続形式で 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 参照してください。
このコード例では、コントロール内の要素内にコントロールを配置する<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 派生したパーツ コントロールのみを含めることができます。
適用対象
こちらもご覧ください
.NET