WebPartZone.ZoneTemplate Proprietà

Definizione

Ottiene o imposta un riferimento a un'istanza ITemplate che contiene i controlli dichiarati nel markup di una pagina Web.

[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; }

Valore della proprietà

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

Attributi

Eccezioni

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>

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

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Vedi anche