EditorZone.ZoneTemplate Propriedade

Definição

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

Fornece um modelo para conter controlos filhos dentro de um EditorZone controlo em formato de persistência 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 Propriedade

ITemplate

Um ITemplate modelo de zona que funciona como um contentor para controlos filhos na zona.

Atributos
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Exemplos

O seguinte exemplo de código demonstra o uso declarativo da ZoneTemplate propriedade. O código completo do exemplo encontra-se na secção Exemplo da EditorZone visão geral da classe.

O exemplo do código demonstra como EditorPart os controlos podem ser colocados dentro de um <zonetemplate> elemento num EditorZone controlo.

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

Quando carregas a página num navegador, podes selecionar o Modo Editar na lista suspensa para mudar para o modo de edição. Para mostrar a interface de utilizador de edição (UI), pode clicar no menu verbos (a seta para baixo) na barra de título de um dos dois controlos e clicar em Editar para editar o controlo. Com a interface de edição visível, podes ver os vários EditorPart controlos que estão declarados dentro do <zonetemplate> elemento.

Observações

A ZoneTemplate propriedade é a principal diferença entre a EditorZone classe e a classe base EditorZoneBase . Ao adicionar suporte para um modelo de zona, a EditorZone classe permite aos programadores de páginas colocar controlos filhos EditorPart dentro de um EditorZone controlo na marcação declarativa de uma página Web. O modelo de zona funciona como um contentor para os controlos filhos.

Note

O acessório de conjunto para a ZoneTemplate propriedade chama o InvalidateEditorParts método, que força a recriação da coleção de EditorPart controlos declarados no template. Isto faz com que quaisquer alterações no conteúdo do modelo sejam reconhecidas.

Para usar um modelo de zona declarativamente dentro de um EditorZone controlo, adiciona-se um par de <zonetemplate> etiquetas e controlos de referência EditorPart entre as etiquetas. Apenas um template de zona é renderizado por instância de um EditorZone controlo (portanto, não há razão para adicionar múltiplos <zonetemplate> elementos a um EditorZone controlo). Além disso, o template de zona de um EditorZone controlo pode conter apenas partes dos controlos que derivam da EditorPart classe.

Aplica-se a

Ver também