EditorZone.ZoneTemplate Propiedad

Definición

Proporciona una plantilla para contener los controles secundarios en un control EditorZone en formato de persistencia de página.

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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))]
[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.TemplateContainer(typeof(System.Web.UI.WebControls.WebParts.EditorZone))>]
[<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

Una plantilla de zona ITemplate que actúa como contenedor para los controles secundarios de la zona.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo de la ZoneTemplate propiedad . El código completo del ejemplo se encuentra en la sección Ejemplo de la información general de la EditorZone clase.

En el ejemplo de código se muestra cómo EditorPart se pueden colocar los controles dentro de un <zonetemplate> elemento de un EditorZone control .

<asp:EditorZone ID="EditorZone1" runat="server" >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>
<asp:EditorZone ID="EditorZone1" runat="server" >
  <VerbStyle Font-Italic="true" />
  <EditUIStyle BackColor="lightgray" />
  <PartChromeStyle BorderWidth="1" />
  <LabelStyle Font-Bold="true" />
  <CancelVerb Text="Cancel Changes" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</asp:EditorZone>

Al cargar la página en un explorador, puede seleccionar Modo de edición en la lista desplegable para cambiar al modo de edición. Para mostrar la interfaz de usuario de edición (UI), puede hacer clic en el menú verbos (la flecha hacia abajo) en la barra de título de uno de los dos controles y hacer clic en Editar para editar el control. Con la interfaz de usuario de edición visible, puede ver los distintos EditorPart controles que se declaran dentro del <zonetemplate> elemento .

Comentarios

La ZoneTemplate propiedad es la diferencia clave entre la EditorZone clase y la clase base EditorZoneBase . Al agregar compatibilidad con una plantilla de zona, la EditorZone clase permite a los desarrolladores de páginas colocar controles secundarios EditorPart dentro de un EditorZone control en el marcado declarativo de una página web. La plantilla de zona actúa como contenedor para los controles secundarios.

Nota

El descriptor de acceso set de la ZoneTemplate propiedad llama al InvalidateEditorParts método , que obliga a que se vuelva a crear la colección de EditorPart controles declarados en la plantilla. Esto hace que se reconozcan los cambios en el contenido de la plantilla.

Para usar una plantilla de zona mediante declaración dentro de un EditorZone control, agregue un par de etiquetas y controles de <zonetemplate> referencia EditorPart entre las etiquetas. Solo se representa una plantilla de zona por instancia de un EditorZone control (por lo tanto, no hay ninguna razón para agregar varios <zonetemplate> elementos a un EditorZone control). Además, la plantilla de zona de un EditorZone control solo puede contener controles de parte que derivan de la EditorPart clase .

Se aplica a

Consulte también