WebPartZone.ZoneTemplate Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite