WebPartZone.ZoneTemplate Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém ou define uma referência para uma instância de ITemplate que contém os controles declarados na marcação de uma página da 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

Valor da propriedade

ITemplate

Um ITemplate que contém os controles WebPart em uma zona.

Atributos

BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Exceções

InvalidOperationException

O registro dos controles WebPart na zona já foi concluído.

Exemplos

O exemplo de código a seguir demonstra o uso da ZoneTemplate propriedade na marcação declarativa de uma página de Web Parts. O código completo do exemplo, incluindo uma classe personalizada e uma página .aspx para hospedar o controle, é encontrado na seção Exemplo do tópico de visão geral da WebPartZone classe.

Observe que, na marcação do WebPartZone controle , há um <zonetemplate> elemento que contém uma referência ao controle Calendar. Se você quiser adicionar controles adicionais WebPart ou outros controles de servidor à zona, também poderá adicioná-los dentro das <zonetemplate> marcas.

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

Comentários

A ZoneTemplate propriedade refere-se a uma ITemplate instância dentro de um WebPartZone controle . O modelo contém controles de servidor estáticos que você pode declarar dentro de um WebPartZone controle, incluindo WebPart controles, controles de usuário, controles personalizados e controles de ASP.NET.

Ao adicionar controles estáticos WebPart ou outros controles de servidor a um WebPartZone na marcação declarativa de uma página da Web, você deve colocar as marcas para os controles dentro de um par de <zonetemplate> marcas. Se você não declarar os controles dentro <zonetemplate> de marcas, uma exceção será gerada.

Confira também

• ITemplate
• Visão geral da personalização de Web Parts
• Controles de Web Parts do ASP.NET