EditorZone.ZoneTemplate Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Fournit un modèle pour contenir des contrôles enfants dans un contrôle EditorZone 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.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

Valeur de propriété

ITemplate

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

Attributs

BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Exemples

L’exemple de code suivant illustre l’utilisation déclarative de la ZoneTemplate propriété . Le code complet de l’exemple se trouve dans la section Exemple de la vue d’ensemble de la EditorZone classe.

L’exemple de code montre comment EditorPart placer des contrôles dans un <zonetemplate> élément d’un EditorZone contrôle.

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

Lorsque vous chargez la page dans un navigateur, vous pouvez sélectionner Mode d’édition dans la liste déroulante pour passer en mode édition. Pour afficher l’interface utilisateur d’édition, vous pouvez cliquer sur le menu des verbes (flèche vers le bas) dans la barre de titre de l’un des deux contrôles, puis cliquer sur Modifier pour modifier le contrôle. Une fois l’interface utilisateur d’édition visible, vous pouvez voir les différents EditorPart contrôles déclarés dans l’élément <zonetemplate> .

Remarques

La ZoneTemplate propriété est la principale différence entre la EditorZone classe et la classe de base EditorZoneBase . En ajoutant la prise en charge d’un modèle de zone, la EditorZone classe permet aux développeurs de pages de placer des contrôles enfants EditorPart dans un EditorZone contrôle dans le balisage déclaratif d’une page Web. Le modèle de zone joue le rôle de conteneur pour les contrôles enfants.

Notes

L’accesseur set de la ZoneTemplate propriété appelle la InvalidateEditorParts méthode , qui force la recréation de la collection de EditorPart contrôles déclarée dans le modèle. Cela entraîne la reconnaissance des modifications apportées au contenu du modèle.

Pour utiliser un modèle de zone de manière déclarative dans un EditorZone contrôle, vous ajoutez une paire de <zonetemplate> balises et référencez EditorPart des contrôles entre les balises. Un seul modèle de zone est rendu par instance d’un EditorZone contrôle (il n’y a donc aucune raison d’ajouter plusieurs <zonetemplate> éléments à un EditorZone contrôle). En outre, le modèle de zone d’un EditorZone contrôle peut contenir uniquement des contrôles de partie qui dérivent de la EditorPart classe .

Voir aussi

• ZoneTemplate
• ITemplate
• InvalidateEditorParts()
• contrôles webPart ASP.NET