CatalogZone.ZoneTemplate Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient ou définit un modèle pour contenir des contrôles enfants dans un contrôle CatalogZone dans le format de persistance de la page.

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

Valeur de propriété

ITemplate

ITemplate qui joue le rôle de conteneur pour les contrôles enfants dans la zone.

Attributs

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Remarques

La ZoneTemplate propriété fait référence à un modèle de type ITemplate utilisé pour contenir les CatalogPart contrôles dans la zone. Le modèle de zone permet aux développeurs de pages de déclarer les CatalogPart contrôles qu’ils souhaitent utiliser au format de persistance, plutôt que d’avoir à créer tous les contrôles par programmation.

L’accesseur set de la ZoneTemplate propriété appelle la InvalidateCatalogParts méthode, qui force l’actualisation de la collection de CatalogPart contrôles déclarés dans le modèle de zone de la page. Cela garantit que la collection de contrôles référencés par la zone reste active chaque fois qu’un utilisateur modifie les contrôles effectivement déclarés dans le modèle sur la page.

Notes pour les héritiers

Si vous souhaitez créer une zone personnalisée CatalogZone , mais que vous envisagez de créer les CatalogPart contrôles par programmation plutôt que d’autoriser les développeurs de pages à les déclarer, vous n’avez pas besoin de prendre en charge les modèles de zone et vous pouvez hériter directement de la CatalogZoneBase classe.

Voir aussi

• ITemplate
• CreateCatalogParts()
• contrôles de composants WebPart ASP.NET