WebPartZone.ZoneTemplate WebPartZone.ZoneTemplate WebPartZone.ZoneTemplate WebPartZone.ZoneTemplate Property

Definizione

Ottiene o imposta un riferimento a un'istanza ITemplate che contiene i controlli dichiarati nel markup di una pagina Web.Gets or sets a reference to an ITemplate instance that contains the controls declared in the markup of a Web page.

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; }
member this.ZoneTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property ZoneTemplate As ITemplate

Valore della proprietà

Un oggetto ITemplate che contiene i controlli WebPart in una zona.An ITemplate that contains the WebPart controls in a zone.

Eccezioni

La registrazione dei controlli WebPart nella zona è già completata.Registration of the WebPart controls in the zone is already complete.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ZoneTemplate l'utilizzo della proprietà nel markup dichiarativo di una pagina di Web part.The following code example demonstrates the use of the ZoneTemplate property in the declarative markup of a Web Parts page. Il codice completo per l'esempio, incluse una classe personalizzata e una pagina aspx per ospitare il controllo, è disponibile nella sezione esempio dell'argomento Panoramica della WebPartZone classe.The full code for the example, including a custom class and an .aspx page to host the control, is found in the Example section of the WebPartZone class overview topic.

Si noti che nel markup per il WebPartZone controllo è presente un <zonetemplate> elemento che contiene un riferimento al controllo Calendar.Notice that, in the markup for the WebPartZone control, there is a <zonetemplate> element that contains a reference to the Calendar control. Se si desidera aggiungere ulteriori WebPart controlli o altri controlli server alla zona, è possibile aggiungerli anche all'interno dei <zonetemplate> tag.If you wanted to add additional WebPart controls or other server controls to the zone, you could also add them within the <zonetemplate> tags.

<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 ITemplate un'istanza di WebPartZone all'interno di un controllo.The ZoneTemplate property refers to an ITemplate instance within a WebPartZone control. Il modello contiene controlli server statici che possono essere dichiarati WebPartZone all'interno di WebPart un controllo, inclusi controlli, controlli utente, controlli personalizzati e controlli ASP.NET.The template contains static server controls that you can declare within a WebPartZone control, including WebPart controls, user controls, custom controls, and ASP.NET controls.

Quando si aggiungono WebPart controlli statici o altri controlli server WebPartZone a un oggetto nel markup dichiarativo di una pagina Web, è necessario inserire i tag per i controlli <zonetemplate> all'interno di una coppia di tag.When you add static WebPart or other server controls to a WebPartZone in the declarative markup of a Web page, you must place the tags for the controls within a pair of <zonetemplate> tags. Se i controlli non vengono dichiarati <zonetemplate> all'interno di tag, viene generata un'eccezione.If you do not declare the controls within <zonetemplate> tags, an exception is thrown.

Si applica a

Vedi anche