Condividi tramite

WebPartZone.ZoneTemplate Proprietà

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

Oggetto ITemplate che contiene i WebPart controlli in una zona.

Attributi
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Eccezioni

InvalidOperationException

La registrazione dei WebPart controlli nella zona è già stata 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 panoramica della WebPartZone classe.

Si noti che, nel markup per il WebPartZone controllo , è presente un <zonetemplate> elemento che contiene un riferimento al controllo Calendario. Se si desidera aggiungere altri WebPart controlli 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