WebPartZone.ZoneTemplate Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Obtiene o establece una referencia a una instancia de ITemplate que contiene los controles declarados en el marcado de una 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 propiedad

ITemplate

Una interfaz ITemplate que contiene los controles WebPart de una zona.

Atributos
BrowsableAttribute PersistenceModeAttribute TemplateInstanceAttribute

Excepciones

InvalidOperationException

El registro de los controles WebPart de la zona ya está completo.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la ZoneTemplate propiedad en el marcado declarativo de una página de elementos web. El código completo del ejemplo, incluida una clase personalizada y una página .aspx para hospedar el control, se encuentra en la sección Ejemplo del tema de información general de la WebPartZone clase.

Observe que, en el marcado del WebPartZone control, hay un <zonetemplate> elemento que contiene una referencia al control Calendar. Si desea agregar controles adicionales WebPart u otros controles de servidor a la zona, también puede agregarlos dentro de las <zonetemplate> etiquetas.

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

Comentarios

La ZoneTemplate propiedad hace referencia a una ITemplate instancia dentro de un WebPartZone control . La plantilla contiene controles de servidor estáticos que puede declarar dentro de un WebPartZone control, incluidos WebPart controles, controles de usuario, controles personalizados y controles ASP.NET.

Al agregar controles estáticos WebPart u otros controles de servidor a en WebPartZone el marcado declarativo de una página web, debe colocar las etiquetas para los controles dentro de un par de <zonetemplate> etiquetas. Si no declara los controles dentro de <zonetemplate> las etiquetas, se produce una excepción.

Se aplica a

Consulte también