WebPartZone.ZoneTemplate Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta un riferimento a un'istanza ITemplate che contiene i controlli dichiarati nel markup di una pagina 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

Valore della proprietà

ITemplate

Un oggetto ITemplate che contiene i controlli WebPart in una zona.

Attributi
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Eccezioni

InvalidOperationException

La registrazione dei controlli WebPart nella zona è già completata.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della ZoneTemplate proprietà nel markup dichiarativo di una pagina Web part. Il codice completo per l'esempio, inclusa una classe personalizzata e una pagina aspx per ospitare il controllo, è disponibile nella sezione Esempio dell'argomento di panoramica della WebPartZone classe.

Si noti che, nel markup per il WebPartZone controllo, è presente un <zonetemplate> elemento che contiene un riferimento al controllo Calendar. Se si desidera aggiungere controlli aggiuntivi WebPart o altri controlli server alla zona, è anche possibile aggiungerli all'interno dei <zonetemplate> tag.

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

Commenti

La ZoneTemplate proprietà fa riferimento a un'istanza ITemplate all'interno di un WebPartZone controllo . Il modello contiene controlli server statici che è possibile dichiarare all'interno di un WebPartZone controllo, inclusi WebPart controlli, controlli utente, controlli personalizzati e controlli ASP.NET.

Quando si aggiungono controlli statici WebPart o altri controlli server a un WebPartZone oggetto nel markup dichiarativo di una pagina Web, è necessario inserire i tag per i controlli all'interno di una coppia di <zonetemplate> tag. Se non si dichiarano i controlli all'interno <zonetemplate> dei tag, viene generata un'eccezione.

Si applica a

Vedi anche