WebPartZone.ZoneTemplate Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Verweis auf eine ITemplate-Instanz ab, in der die im Markup einer Webseite deklarierten Steuerelemente enthalten sind, oder legt diese Instanz fest.

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

Eigenschaftswert

ITemplate

Eine ITemplate-Vorlage, die die WebPart-Steuerelemente in einer Zone enthält.

Attribute: BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Ausnahmen

InvalidOperationException

Die Registrierung der WebPart-Steuerelemente in der Zone ist bereits abgeschlossen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ZoneTemplate -Eigenschaft im deklarativen Markup einer Webpartseite veranschaulicht. Den vollständigen Code für das Beispiel, einschließlich einer benutzerdefinierten Klasse und einer ASPX-Seite zum Hosten des Steuerelements, finden Sie im Abschnitt Beispiel des WebPartZone Themas Klassenübersicht.

Beachten Sie, dass im Markup für das WebPartZone Steuerelement ein <zonetemplate> Element vorhanden ist, das einen Verweis auf das Calendar-Steuerelement enthält. Wenn Sie der Zone zusätzliche WebPart Steuerelemente oder andere Serversteuerelemente hinzufügen möchten, können Sie diese auch innerhalb der <zonetemplate> Tags hinzufügen.

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

Hinweise

Die ZoneTemplate -Eigenschaft verweist auf eine ITemplate Instanz innerhalb eines Steuerelements WebPartZone . Die Vorlage enthält statische Serversteuerelemente, die Sie innerhalb eines WebPartZone Steuerelements deklarieren können, einschließlich WebPart Steuerelementen, Benutzersteuerelementen, benutzerdefinierten Steuerelementen und ASP.NET-Steuerelementen.

Wenn Sie statische WebPart oder andere Serversteuerelemente zu einem WebPartZone im deklarativen Markup einer Webseite hinzufügen, müssen Sie die Tags für die Steuerelemente innerhalb eines Tagspaars <zonetemplate> platzieren. Wenn Sie die Steuerelemente in <zonetemplate> Tags nicht deklarieren, wird eine Ausnahme ausgelöst.

Gilt für: