EditorZone.ZoneTemplate Propriedade

  • Referência

Definição

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

Fornece um modelo para conter controles filho dentro de um controle EditorZone no 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 da propriedade

ITemplate

Um ITemplate modelo de zona que atua como um contêiner para controles filho na zona.

Atributos
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute TemplateInstanceAttribute

Exemplos

O exemplo de código a seguir demonstra o uso declarativo da ZoneTemplate propriedade . O código completo do exemplo é encontrado na seção Exemplo da visão geral da EditorZone classe.

O exemplo de código demonstra como os EditorPart controles podem ser colocados dentro de um <zonetemplate> elemento em um EditorZone controle .

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

Ao carregar a página em um navegador, você pode selecionar Modo de Edição na lista suspensa para alternar para o modo de edição. Para exibir a interface do usuário de edição, você pode clicar no menu de verbos (a seta para baixo) na barra de título de um dos dois controles e clicar em Editar para editar o controle. Com a interface do usuário de edição visível, você pode ver os vários EditorPart controles declarados dentro do <zonetemplate> elemento .

Comentários

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 classe permite que os EditorZone desenvolvedores de página coloquem controles filho EditorPart dentro de um EditorZone controle na marcação declarativa de uma página da Web. O modelo de zona atua como um contêiner para os controles filho.

Observação

O acessador set para a ZoneTemplate propriedade chama o InvalidateEditorParts método , o que força a coleção de EditorPart controles declarados no modelo a ser recriado. Isso faz com que as alterações no conteúdo do modelo sejam reconhecidas.

Para usar um modelo de zona declarativamente dentro de um EditorZone controle, adicione um par de marcas e controles de <zonetemplate> referência EditorPart entre as marcas. Somente um modelo de zona é renderizado por instância de um EditorZone controle (portanto, não há motivo para adicionar vários <zonetemplate> elementos a um EditorZone controle). Além disso, o modelo de zona de um EditorZone controle pode conter apenas controles de parte derivados da EditorPart classe .

Aplica-se a

Confira também