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 Example 區段中找到。
此程式代碼範例示範如何在 EditorPart 控件的 元素內<zonetemplate>
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) ,您可以按下動詞功能表, (兩個控件之一標題欄中的向下箭號) ,然後按兩下 [ 編輯 ] 來編輯控件。 當編輯 UI 可見時,您可以看到元素內<zonetemplate>
宣告的數EditorPart個控件。
備註
屬性ZoneTemplate是 類別與基EditorZoneBase類之間的EditorZone主要差異。 藉由新增區域範本的支持,類別 EditorZone 可讓頁面開發人員將子 EditorPart 控件 EditorZone 放在網頁的宣告式標記中。 區域範本可作為子控件的容器。
注意
屬性的 ZoneTemplate set 存取子會呼叫 InvalidateEditorParts 方法,以強制重新建立範本中宣告的控件集合 EditorPart 。 這會導致辨識範本內容中的任何變更。
若要以宣告方式在控件內 EditorZone 使用區域範本,您可以在標記之間新增一對 <zonetemplate>
標記和參考 EditorPart 控件。 因此,每個控件實例只會轉譯一個 EditorZone 區域範本 (,因此沒有理由將多個 <zonetemplate>
元素新增至 EditorZone 控件) 。 此外,控件的區域範本只能包含衍生自 類別的EditorZoneEditorPart元件控制件。