EditorZone.ZoneTemplate Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller en mall som innehåller underordnade kontroller i en EditorZone kontroll i sidpersistenceformat.
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
Egenskapsvärde
En ITemplate zonmall som fungerar som en container för underordnade kontroller i zonen.
- Attribut
Exempel
Följande kodexempel visar deklarativ användning av ZoneTemplate egenskapen. Den fullständiga koden för exemplet finns i avsnittet Exempel i klassöversikten EditorZone .
Kodexemplet visar hur EditorPart kontroller kan placeras i ett <zonetemplate> element i en EditorZone kontroll.
<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>
När du läser in sidan i en webbläsare kan du välja Redigera läge i listrutan för att växla till redigeringsläge. Om du vill visa användargränssnittet för redigering kan du klicka på verbmenyn (nedåtpilen) i namnlisten för en av de två kontrollerna och klicka på Redigera för att redigera kontrollen. Med redigeringsgränssnittet synligt kan du se de flera EditorPart kontroller som deklareras i elementet <zonetemplate> .
Kommentarer
Egenskapen ZoneTemplate är den viktigaste skillnaden mellan EditorZone klassen och basklassen EditorZoneBase . Genom att lägga till stöd för en zonmall EditorZone gör klassen det möjligt för sidutvecklare att placera underordnade EditorPart kontroller i en EditorZone kontroll i den deklarativa markeringen på en webbsida. Zonmallen fungerar som en container för de underordnade kontrollerna.
Note
Set-accessorn för ZoneTemplate egenskapen anropar InvalidateEditorParts metoden som tvingar samlingen av EditorPart kontroller som deklarerats i mallen att återskapas. Detta gör att ändringar i innehållet i mallen identifieras.
Om du vill använda en zonmall deklarativt inom en EditorZone kontroll lägger du till ett par <zonetemplate> taggar och referenskontroller EditorPart mellan taggarna. Endast en zonmall återges per instans av en EditorZone kontroll (därför finns det ingen anledning att lägga till flera <zonetemplate> element i en EditorZone kontroll). Zonmallen för en EditorZone kontroll kan också endast innehålla delkontroller som härleds EditorPart från klassen.