WebPartZone.ZoneTemplate Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Partilhar via