WebPartZone.ZoneTemplate Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

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

ITemplate

E ITemplate que contém os WebPart controlos numa zona.

Atributos
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Exceções

InvalidOperationException

O registo dos WebPart controlos na zona já está concluído.

Exemplos

O seguinte exemplo de código demonstra a utilização 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 alojar o controlo, encontra-se na secção Exemplo do WebPartZone tópico de visão geral da classe.

Note que, na marcação do WebPartZone controlo, há um <zonetemplate> elemento que contém uma referência ao controlo Calendário. Se quiseres adicionar controlos adicionais WebPart ou outros controlos de servidor à zona, também podes adicioná-los dentro das <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>

Observações

A ZoneTemplate propriedade refere-se a uma ITemplate instância dentro de um WebPartZone controlo. O template contém controlos estáticos de servidor que pode declarar dentro de um controlo WebPartZone, incluindo controlos WebPart, controlos de utilizador, controlos personalizados e controlos ASP.NET.

Quando adiciona controlos estáticos WebPart ou outros controlos de servidor a WebPartZone na marcação declarativa de uma página Web, deve colocar as etiquetas dos controlos dentro de um par de <zonetemplate> tags. Se não declarares os controlos dentro <zonetemplate> das tags, é lançada uma exceção.

Aplica-se a

Ver também