WebPartZone.ZoneTemplate Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient ou définit une référence à une instance de ITemplate qui contient les contrôles déclarés dans la balise d'une page Web.

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.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.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 contient les contrôles WebPart d'une zone.

Attributs
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Exceptions

InvalidOperationException

L'inscription des contrôles WebPart dans la zone est déjà terminée.

Exemples

L’exemple de code suivant illustre l’utilisation de la ZoneTemplate propriété dans le balisage déclaratif d’une page de composants WebPart. Le code complet de l’exemple, y compris une classe personnalisée et une page .aspx pour héberger le contrôle, se trouve dans la section Exemple de la rubrique vue d’ensemble de la WebPartZone classe.

Notez que, dans le balisage du WebPartZone contrôle, il existe un <zonetemplate> élément qui contient une référence au contrôle Calendar. Si vous souhaitez ajouter des contrôles supplémentaires WebPart ou d’autres contrôles serveur à la zone, vous pouvez également les ajouter dans les <zonetemplate> balises.

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

Remarques

La ZoneTemplate propriété fait référence à une ITemplate instance au sein d’un WebPartZone contrôle. Le modèle contient des contrôles serveur statiques que vous pouvez déclarer dans un WebPartZone contrôle, notamment WebPart des contrôles, des contrôles utilisateur, des contrôles personnalisés et des contrôles ASP.NET.

Lorsque vous ajoutez des contrôles statiques WebPart ou d’autres contrôles serveur à un WebPartZone dans le balisage déclaratif d’une page web, vous devez placer les balises pour les contrôles dans une paire de <zonetemplate> balises. Si vous ne déclarez pas les contrôles dans <zonetemplate> les balises, une exception est levée.

S’applique à

Voir aussi