CatalogZone.ZoneTemplate Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft eine Vorlage ab, die als Container für untergeordnete Steuerelemente in einem CatalogZone-Steuerelement im seitenpersistenten Format fungiert, oder legt diese 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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.CatalogZone))]
[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.CatalogZone))>]
[<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, die als Container für untergeordnete Steuerelemente in der Zone fungiert.

Attribute

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Hinweise

Die ZoneTemplate -Eigenschaft verweist auf eine Vorlage vom Typ ITemplate , die verwendet wird, um die CatalogPart Steuerelemente in der Zone zu enthalten. Mit der Zonenvorlage können Seitenentwickler die Steuerelemente, die CatalogPart sie verwenden möchten, im Persistenzformat deklarieren, anstatt alle Steuerelemente programmgesteuert erstellen zu müssen.

Der Set-Accessor für die ZoneTemplate -Eigenschaft ruft die InvalidateCatalogParts -Methode auf, die erzwingt, dass die Auflistung von CatalogPart Steuerelementen, die in der Zonenvorlage auf der Seite deklariert sind, aktualisiert wird. Dadurch wird sichergestellt, dass die Auflistung der Steuerelemente, auf die von der Zone verwiesen wird, immer aktuell bleibt, wenn ein Benutzer die tatsächlich in der Vorlage auf der Seite deklarierten Steuerelemente ändert.

Hinweise für Vererber

Wenn Sie eine benutzerdefinierte CatalogZone Zone erstellen möchten, aber die CatalogPart Steuerelemente programmgesteuert erstellen möchten, anstatt sie von Seitenentwicklern zu deklarieren, benötigen Sie keine Zonenvorlagenunterstützung, und Sie können direkt von der -Klasse erben CatalogZoneBase .

Weitere Informationen

• ITemplate
• CreateCatalogParts()
• ASP.NET Webpart-Steuerelemente