EditorZone.ZoneTemplate Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een sjabloon voor het bevatten van onderliggende besturingselementen in een EditorZone besturingselement in de indeling voor paginapersistentie.
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
Waarde van eigenschap
Een ITemplate zonesjabloon die fungeert als een container voor onderliggende besturingselementen in de zone.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u een declaratief gebruik van de ZoneTemplate eigenschap. De volledige code voor het voorbeeld vindt u in de sectie Voorbeeld van het EditorZone klassenoverzicht.
In het codevoorbeeld ziet u hoe EditorPart besturingselementen in een <zonetemplate> element in een EditorZone besturingselement kunnen worden geplaatst.
<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>
Wanneer u de pagina in een browser laadt, kunt u de bewerkingsmodus selecteren in de vervolgkeuzelijst om over te schakelen naar de bewerkingsmodus. Als u de gebruikersinterface (UI) voor bewerken wilt weergeven, klikt u op het menu Werkwoorden (de pijl-omlaag) in de titelbalk van een van de twee besturingselementen en klikt u op Bewerken om het besturingselement te bewerken. Als de bewerkingsinterface zichtbaar is, ziet u de verschillende EditorPart besturingselementen die in het <zonetemplate> element zijn gedeclareerd.
Opmerkingen
De ZoneTemplate eigenschap is het belangrijkste verschil tussen de EditorZone klasse en de basisklasse EditorZoneBase . Door ondersteuning voor een zonesjabloon toe te voegen, kunnen paginaontwikkelaars met de EditorZone klasse onderliggende EditorPart besturingselementen in een EditorZone besturingselement plaatsen in de declaratieve markeringen van een webpagina. De zonesjabloon fungeert als een container voor de onderliggende besturingselementen.
Note
De set-accessor voor de ZoneTemplate eigenschap roept de InvalidateEditorParts methode aan, waardoor de verzameling EditorPart besturingselementen die in de sjabloon zijn gedeclareerd, opnieuw moet worden gemaakt. Dit zorgt ervoor dat wijzigingen in de inhoud van de sjabloon worden herkend.
Als u een zonesjabloon declaratief binnen een EditorZone besturingselement wilt gebruiken, voegt u een paar <zonetemplate> tags toe en verwijst u naar EditorPart besturingselementen tussen de tags. Er wordt slechts één zonesjabloon weergegeven per exemplaar van een EditorZone besturingselement (daarom is er geen reden om meerdere <zonetemplate> elementen aan een EditorZone besturingselement toe te voegen). De zonesjabloon van een EditorZone besturingselement kan ook alleen deelbesturingselementen bevatten die zijn afgeleid van de EditorPart klasse.