EditorZone.ZoneTemplate Propriété

Définition

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é

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

Attributs

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 les contrôles peuvent être placés 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 de modification, vous pouvez cliquer sur le menu 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 qui sont déclarés dans l’élément <zonetemplate> .

Remarques

La ZoneTemplate propriété est la différence clé 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 fait office de conteneur pour les contrôles enfants.

Notes

L’accesseur set de la ZoneTemplate propriété appelle la InvalidateEditorParts méthode, ce qui force la recréation de la collection de EditorPart contrôles déclarés 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 balises et des contrôles de <zonetemplate> référence EditorPart 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 ne peut contenir que des contrôles de partie qui dérivent de la EditorPart classe .

S’applique à

Voir aussi