Taal

EditorZone.ZoneTemplate Eigenschap

Definitie

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.

Van toepassing op

Zie ook