EditorZone.ZoneTemplate Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Stellt eine Vorlage als Container von untergeordneten Steuerelementen in einem EditorZone-Steuerelement im seitenpersistenten Format bereit.

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

Eigenschaftswert

ITemplate

Eine ITemplate-Zonenvorlage, die als Container für untergeordnete Steuerelemente in der Zone fungiert.

Attribute

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Beispiele

Im folgenden Codebeispiel wird die deklarative Verwendung der ZoneTemplate -Eigenschaft veranschaulicht. Den vollständigen Code für das Beispiel finden Sie im Abschnitt Beispiel der EditorZone Klassenübersicht.

Das Codebeispiel veranschaulicht, wie EditorPart Steuerelemente in einem <zonetemplate> -Element in einem EditorZone -Steuerelement platziert werden können.

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

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Bearbeitungsmodus auswählen, um in den Bearbeitungsmodus zu wechseln. Um die Bearbeitungsbenutzeroberfläche anzuzeigen, können Sie auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste eines der beiden Steuerelemente klicken und dann auf Bearbeiten klicken, um das Steuerelement zu bearbeiten. Wenn die Bearbeitungsoberfläche sichtbar ist, können Sie die verschiedenen EditorPart Steuerelemente sehen, die innerhalb des <zonetemplate> Elements deklariert sind.

Hinweise

Die ZoneTemplate -Eigenschaft ist der hauptunterschied zwischen der EditorZone -Klasse und der Basisklasse EditorZoneBase . Durch Hinzufügen von Unterstützung für eine Zonenvorlage ermöglicht die EditorZone -Klasse Seitenentwicklern, untergeordnete EditorPart Steuerelemente in einem EditorZone Steuerelement im deklarativen Markup einer Webseite zu platzieren. Die Zonenvorlage fungiert als Container für die untergeordneten Steuerelemente.

Hinweis

Der set-Accessor für die ZoneTemplate -Eigenschaft ruft die InvalidateEditorParts -Methode auf, die erzwingt, dass die Auflistung der EditorPart in der Vorlage deklarierten Steuerelemente neu erstellt wird. Dadurch werden alle Änderungen am Inhalt der Vorlage erkannt.

Um eine Zonenvorlage deklarativ innerhalb eines Steuerelements EditorZone zu verwenden, fügen Sie ein Paar von <zonetemplate> Tags hinzu und verweisen auf EditorPart Steuerelemente zwischen den Tags. Pro Instanz eines EditorZone Steuerelements wird nur eine Zonenvorlage gerendert (daher gibt es keinen Grund, einem EditorZone Steuerelement mehrere <zonetemplate> Elemente hinzuzufügen). Außerdem kann die Zonenvorlage eines Steuerelements EditorZone nur Teilsteuerelemente enthalten, die von der EditorPart -Klasse abgeleitet sind.

Weitere Informationen

• ZoneTemplate
• ITemplate
• InvalidateEditorParts()
• ASP.NET Webparts-Steuerelemente