WebPartZone.ZoneTemplate Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Hiermee haalt u een verwijzing op naar een ITemplate exemplaar dat de besturingselementen bevat die zijn gedeclareerd in de markering van een webpagina.

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.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.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

ITemplate

Een ITemplate met de WebPart besturingselementen in een zone.

Kenmerken
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Uitzonderingen

InvalidOperationException

De registratie van de WebPart besturingselementen in de zone is al voltooid.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de ZoneTemplate eigenschap in de declaratieve opmaak van een pagina met webonderdelen. De volledige code voor het voorbeeld, met inbegrip van een aangepaste klasse en een .aspx-pagina voor het hosten van het besturingselement, vindt u in de sectie Voorbeeld van het onderwerp over het WebPartZone klassenoverzicht.

U ziet dat er in de markeringen voor het WebPartZone besturingselement een <zonetemplate> element is dat een verwijzing naar het besturingselement Agenda bevat. Als u extra WebPart besturingselementen of andere serverbesturingselementen aan de zone wilt toevoegen, kunt u ze ook toevoegen binnen de <zonetemplate> tags.

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

Opmerkingen

De ZoneTemplate eigenschap verwijst naar een ITemplate exemplaar binnen een WebPartZone besturingselement. De sjabloon bevat statische serverbesturingselementen die u kunt declareren binnen een WebPartZone-besturingselement, waaronder WebPart besturingselementen, gebruikersbesturingselementen, aangepaste besturingselementen en ASP.NET besturingselementen.

Wanneer u statische WebPart of andere serverbesturingselementen toevoegt aan een WebPartZone in de declaratieve markering van een webpagina, moet u de tags voor de besturingselementen binnen een paar <zonetemplate> tags plaatsen. Als u de besturingselementen binnen <zonetemplate> tags niet declareert, wordt er een uitzondering gegenereerd.

Van toepassing op

Zie ook