EditorZoneBase Classe

Definição

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

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Serve como classe base para todos os controlos de zona que funcionam como contentores para EditorPart os controlos.

public ref class EditorZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone

public abstract class EditorZoneBase : System.Web.UI.WebControls.WebParts.ToolZone

type EditorZoneBase = class
    inherit ToolZone

Public MustInherit Class EditorZoneBase
Inherits ToolZone

Herança: Object

Control

WebControl

CompositeControl

WebZone

ToolZone
EditorZoneBase

Derivado: System.Web.UI.WebControls.WebParts.EditorZone

Exemplos

O exemplo de código seguinte demonstra várias utilizações declarativas e programáticas da EditorZoneBase classe. Como a classe é abstrata, os exemplos de código usam a classe derivada EditorZone que vem com o conjunto de controlo Web Parts, demonstrando as propriedades e métodos que herda da EditorZoneBase classe.

O exemplo de código tem quatro partes:

Um controlo do utilizador que permite alterar os modos de visualização na página Web.
Uma página Web que contém um EditorZone controlo.
Uma classe personalizada EditorZone que demonstra alguns dos EditorZoneBase membros da turma.
Uma descrição de como o exemplo funciona num navegador.

O código-fonte do controlo do utilizador vem de outro tópico. Para que este exemplo de código funcione, precisa de obter o ficheiro .ascx para o controlo do utilizador a partir do tópico Walkthrough: Changing Display Modes on a Web Parts Page , e colocar o ficheiro na mesma pasta da página .aspx neste exemplo de código.

A segunda parte do exemplo do código é uma página Web que contém uma referência declarativa a um EditorZone controlo. Perto do topo da página há uma Register diretiva para o controlo do utilizador. A etiqueta de controlo do utilizador é declarada na página com um <uc1:DisplayModeMenu> elemento. Note que, abaixo do <asp:WebPartZone> elemento, existe um <asp:EditorZone> elemento que contém EditorPart controlos, e tem uma variedade de etiquetas e propriedades definidas para determinar a sua aparência e comportamento. A maior parte do código na página demonstra as várias utilizações programáticas das EditorZoneBase propriedades e métodos.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3> 

  // <snippet4> 
  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }
  // </snippet4>
  // <snippet5> 
  void Button2_Click(object sender, EventArgs e)
  {
    if (EditorZone1.CancelVerb.Enabled)
      EditorZone1.CancelVerb.Enabled = false;
    else
      EditorZone1.CancelVerb.Enabled = true;
  }
  // </snippet5>
  // <snippet6>
  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet6>
  // <snippet7>
  void Button4_Click(object sender, EventArgs e)
  {
    if (EditorZone1.OKVerb.Enabled)
      EditorZone1.OKVerb.Enabled = false;
    else
      EditorZone1.OKVerb.Enabled = true;
  }
  // </snippet7>
  
// </snippet3>    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3> 

  ' <snippet4> 
  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
  ' </snippet4>
  ' <snippet5> 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.CancelVerb.Enabled Then
      EditorZone1.CancelVerb.Enabled = False
    Else
      EditorZone1.CancelVerb.Enabled = True
    End If
  End Sub
  ' </snippet5>
  ' <snippet6>
  Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "<br />"
    Dim part As EditorPart
    For Each part In EditorZone1.EditorParts
      Label1.Text += part.ID + "<br />"
    Next part
  End Sub
  ' </snippet6>
  ' <snippet7>
  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.OKVerb.Enabled Then
      EditorZone1.OKVerb.Enabled = False
    Else
      EditorZone1.OKVerb.Enabled = True
    End If

  End Sub
  ' </snippet7>
  
  ' </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

A terceira parte do exemplo do código é uma classe personalizada EditorZone que mostra como trabalhar com vários membros da EditorZoneBase classe. A classe personalizada deriva de EditorZone para poder ser usada com um modelo de zona na marcação declarativa da página Web. Para que o exemplo de código seja executado, tens de compilar este código-fonte. Pode compilar explicitamente e colocar o assembly resultante na pasta Bin do seu site ou na cache global assembly. Alternativamente, pode colocar o código-fonte na pasta App_Code do seu site, onde será compilado dinamicamente em tempo de execução. Este exemplo de código utiliza compilação dinâmica; assim, notará que a Register diretiva perto do topo da página Web não faz referência a um ficheiro assembly. Para um guia que demonstra ambos os métodos de compilação, veja Guia: Desenvolvimento e Utilização de um Controlo de Servidor Web Personalizado.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyEditorZone : EditorZone
  {
    public MyEditorZone()
    {
    }
    protected override void OnDisplayModeChanged(object sender, 
      WebPartDisplayModeEventArgs e)
    {
      this.BackColor = Color.LightGray;
      base.OnDisplayModeChanged(sender, e);
    }
    protected override void OnSelectedWebPartChanged(object sender, 
      WebPartEventArgs e)
    {
      if (e.WebPart != null)
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
          Color.LightGreen;
      base.OnSelectedWebPartChanged(sender, e);
    }
    protected override void RenderBody(HtmlTextWriter writer)
    {
      writer.WriteLine("<hr />");
      base.RenderBody(writer);
    }
    protected override void RenderVerbs(HtmlTextWriter writer)
    {
      WebPartVerb[] verbs = new WebPartVerb[] { OKVerb, 
        CancelVerb, ApplyVerb };
      foreach (WebPartVerb verb in verbs)
      {
        if (verb != null)
          verb.Text += " Verb";
      }
      base.RenderVerbs(writer);
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyEditorZone
    Inherits EditorZone

    Public Sub New()
    End Sub

    Protected Overrides Sub OnDisplayModeChanged(ByVal sender _
      As Object, ByVal e As WebPartDisplayModeEventArgs)
      Me.BackColor = Color.LightGray
      MyBase.OnDisplayModeChanged(sender, e)
    End Sub
    Protected Overrides Sub OnSelectedWebPartChanged(ByVal sender _
      As Object, ByVal e As WebPartEventArgs)
      If Not (e.WebPart Is Nothing) Then
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = _
          Color.LightGreen
      End If
      MyBase.OnSelectedWebPartChanged(sender, e)

    End Sub
    Protected Overrides Sub RenderBody(ByVal writer As _
      HtmlTextWriter)
      writer.WriteLine("<hr />")
      MyBase.RenderBody(writer)
    End Sub
    Protected Overrides Sub RenderVerbs(ByVal writer As _
      HtmlTextWriter)
      Dim verbs() As WebPartVerb = {OKVerb, CancelVerb, ApplyVerb}
      Dim verb As WebPartVerb
      For Each verb In verbs
        If Not (verb Is Nothing) Then
          verb.Text += " Verb"
        End If
      Next verb
      MyBase.RenderVerbs(writer)
    End Sub
  End Class

End Namespace

Quando carregas a página num navegador, podes selecionar o Modo Editar na lista suspensa para mudar para o modo de edição. Podes clicar no menu de verbos (a seta para baixo) na barra de título de um dos dois controlos e clicar em Editar para editar o controlo. Quando a interface de edição está visível, pode ver os efeitos dos vários usos declarativos e programáticos dos EditorZoneBase membros da classe.

Observações

A EditorZoneBase classe é uma classe de zona especializada que herda da ToolZone classe e fornece um conjunto base de comportamentos para zonas derivadas que contêm EditorPart controlos. Existem vários outros tipos de ToolZone disciplinas; para mais informações, consulte o tópico de visão geral da ToolZone disciplina. Tal como noutras zonas de ferramentas, EditorZoneBase as zonas não são visíveis quando uma página está em modo normal de navegação; só são visíveis quando uma página está em modo de visualização de edição. Tal como nas outras zonas de ferramentas, EditorZoneBase as zonas só podem conter o tipo especial de controlos para os quais foram concebidas (neste caso, EditorPart controlos).

As EditorZoneBase zonas fornecem uma interface especial para os controlos de edição que contêm. Muitos destes elementos de interface são comuns a todas as zonas do conjunto de controlo Web Parts. Para uma discussão detalhada dos elementos comuns da interface de utilizador nas zonas Web Parts, consulte o tópico de visão geral da WebZone disciplina.

Como a EditorZoneBase disciplina é abstrata, não podes usá-la diretamente numa página Web. Em vez disso, deve usar um controlo que herde da EditorZoneBase classe e implemente o seu comportamento. Pode usar a zona derivada fornecida no conjunto de controlos Web Parts, o EditorZone controlo, ou pode derivar o seu próprio controlo personalizado EditorZoneBase .

A EditorZoneBase classe fornece uma interface de utilizador comum (UI) que contém controlos especiais que permitem aos utilizadores finais editar as propriedades, o layout, a aparência e outros atributos dos WebPart controlos. Algumas propriedades que se aplicam à UI referem-se a verbos, como o ApplyVerb, CancelVerb, e OKVerb as propriedades. Os verbos são ações comuns realizadas pelos utilizadores numa página, e são representados na interface por botões, links, itens do menu ou outros elementos. Por exemplo, quando os utilizadores editam propriedades num controlo, podem clicar em aplicar verbo para guardar as alterações.

Várias outras propriedades afetam o texto que é exibido em vários pontos da interface de edição. Estas incluem as EmptyZoneText, ErrorText, HeaderText, e InstructionText as propriedades.

Duas propriedades importantes fornecem referências a controlos relacionados. A EditorParts propriedade é um conjunto dos controlos EditorPart contidos na zona. A propriedade WebPartToEdit é uma referência a um objeto a um controlo contido num WebPartZone — que pode ser um controlo WebPart ou qualquer outro controlo ASP.NET servidor, controlo de utilizador ou controlo personalizado que esteja a ser editado.

Finalmente, a EditorPartChrome propriedade refere-se a uma instância de um EditorPartChrome objeto associada à zona, e que contém características de estilo dos elementos periféricos da interface (conhecidos como chrome), como títulos e estilos de borda para EditorPart controlos na zona.

Vários dos métodos da EditorZoneBase classe são especializados para lidar com a edição de outros controlos. O Close método altera a página do modo de exibição de edição para uma vista normal de navegação. O CreateEditorPartChrome método serve para criar o chrome (elementos periféricos da interface como uma borda, verbos, ícones e um título) que envolve cada EditorPart controlo na zona. O CreateEditorParts método é abstrato; classes derivadas sobrepõem-se a ele para criar instâncias de todos os EditorPart controlos contidos na zona. O InvalidateEditorParts método pode ser chamado por uma classe derivada se a coleção de EditorPart controlos na zona mudar por alguma razão programática, o que sinaliza o conjunto de controlos Web Parts para recriar e atualizar a coleção de EditorPart controlos. O OnDisplayModeChanged método é usado para definir a coleção de EditorPart controlos para null quando o modo de exibição muda do modo de edição para o modo de navegação. Finalmente, o OnSelectedWebPartChanged método é usado para lidar com o evento quando um WebPart controlo está a entrar ou a sair do modo de edição. Por exemplo, este método é um local conveniente para sincronizar os valores das propriedades de um WebPart controlo com os valores editáveis nos controlos associados EditorPart .

Notas para Implementadores

Se quiser desenvolver uma zona personalizada para controlos de alojamento EditorPart , deve determinar se pretende fornecer suporte a modelos de zona. Um modelo de zona é criado por tipos que implementam a ITemplate interface, e é necessário se quiser permitir que os programadores de páginas que usam a sua zona personalizada possam referenciar EditorPart controlos dentro da sua zona na marcação declarativa de uma página Web. Se precisares de suporte para modelos de zona, deves herdar da EditorZone classe.

Em contraste, se a tua zona personalizada e os seus EditorPart controlos forem autónomos, e forem criados programaticamente sem qualquer opção para os programadores de páginas especificarem controlos declarativamente num template de zona, então podes herdar diretamente da EditorZoneBase classe. Se fizeres isto, é fundamental que implementes o CreateEditorParts() método para que a tua zona personalizada funcione.

Construtores

Name	Description
EditorZoneBase()	Inicializa a classe para uso por uma instância de classe herdada. Este construtor só pode ser chamado por uma classe herdada.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl)
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
ApplyVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais aplicar alterações de edição a um controlo em modo de edição.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
AssociatedDisplayModes	Obtém a coleção de WebPartDisplayMode objetos associados a uma determinada ToolZone zona. (Herdado de ToolZone)
Attributes	Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl)
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl)
BackImageUrl	Obtém ou define o URL para uma imagem de fundo de uma zona. (Herdado de WebZone)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl)
CancelVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais cancelar alterações de edição a um controlo em modo de edição.
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos num CompositeControl. (Herdado de CompositeControl)
ControlStyle	Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
ControlStyleCreated	Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
CssClass	Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
Display	Recebe um valor que indica se um ToolZone controlo está atualmente apresentado.
EditorPartChrome	Obtém uma referência à instância da EditorPartChrome classe associada à EditorZoneBase zona.
EditorParts	Obtém uma coleção de todos os EditorPart controlos contidos numa EditorZoneBase zona.
EditUIStyle	Obtém os atributos de estilo dos controlos editáveis contidos num ToolZone controlo. (Herdado de ToolZone)
EmptyZoneText	Recebe ou define uma mensagem que aparece quando uma zona não contém controlos.
EmptyZoneTextStyle	Obtém os atributos de estilo do texto provisório numa zona vazia. (Herdado de WebZone)
Enabled	Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl)
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
ErrorStyle	Recebe os atributos de estilo para renderizar a mensagem de erro que é exibida se um WebPart controlo não puder ser carregado ou criado. (Herdado de WebZone)
ErrorText	Recebe ou define o texto de uma mensagem de erro a nível de zona para ser exibido no topo da interface de utilizador de edição (UI).
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
Font	Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl)
FooterStyle	Obtém os atributos de estilo para o conteúdo da área do rodapé de uma zona. (Herdado de WebZone)
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl)
HasAttributes	Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
HasFooter	Obtém um valor que indica se uma zona tem uma área de rodapé. (Herdado de WebZone)
HasHeader	Recebe um valor que indica se uma zona tem uma área de cabeçalho. (Herdado de WebZone)
HeaderCloseVerb	Obtém uma referência ao WebPartVerb objeto no cabeçalho de um ToolZone controlo que é usado para fechar o controlo. (Herdado de ToolZone)
HeaderStyle	Obtém os atributos de estilo para o conteúdo da área de cabeçalho de uma zona. (Herdado de WebZone)
HeaderText	Recebe ou define o texto para a área do cabeçalho de uma zona.
HeaderVerbStyle	Obtém os atributos de estilo para todos os verbos de cabeçalho apresentados num ToolZone controlo. (Herdado de ToolZone)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
InstructionText	Recebe ou define o texto num ToolZone controlo que fornece instruções para os utilizadores finais.
InstructionTextStyle	Obtém os atributos de estilo do texto de instrução que aparece no topo de um ToolZone controlo. (Herdado de ToolZone)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsEnabled	Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LabelStyle	Obtém os atributos de estilo para o conteúdo das etiquetas que aparecem ao lado dos controlos de edição dentro de um ToolZone controlo. Os controlos derivados ToolZone , como CatalogZone e EditorZone, aplicam os estilos às etiquetas. (Herdado de ToolZone)
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
OKVerb	Recebe uma referência a um WebPartVerb objeto que aplica alterações de edição a um controlo no modo de edição e esconde a interface de utilizador (UI) de edição.
Padding	Obtém ou define os atributos de preenchimento da célula na tabela que contém os WebPart controlos numa zona. (Herdado de WebZone)
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
PartChromePadding	Obtém ou define a distância entre o conteúdo de um WebPart controlo e a fronteira do controlo. (Herdado de WebZone)
PartChromeStyle	Obtém características de estilo que se aplicam às fronteiras dos controlos Web Parts contidas por uma zona. (Herdado de WebZone)
PartChromeType	Obtém ou define o tipo de borda que enquadra os controlos de Web Parts contidos por uma zona. (Herdado de WebZone)
PartStyle	Obtém características de estilo que se aplicam à borda e ao conteúdo de cada controlo Web Parts contido por uma zona. (Herdado de WebZone)
PartTitleStyle	Obtém atributos de estilo para o conteúdo da barra de título de cada controlo Web Parts contido por uma zona. (Herdado de WebZone)
RenderClientScript	Recebe um valor que indica se deve renderizar o script cliente numa página de Web Parts. (Herdado de WebZone)
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl)
Style	Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controlo deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é `false`. (Herdado de CompositeControl)
TabIndex	Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebZone)
TagName	Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
VerbButtonType	Obtém ou define que tipo de botão é usado para representar verbos numa zona. (Herdado de WebZone)
VerbStyle	Obtém os atributos de estilo para os verbos da interface de utilizador (UI) associados aos controlos Web Parts numa zona. (Herdado de WebZone)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como um elemento da interface de utilizador (UI) na página. (Herdado de ToolZone)
WebPartManager	Obtém uma referência ao WebPartManager controlo associado a uma WebZone instância de controlo numa página de Web Parts. (Herdado de WebZone)
WebPartToEdit	Recebe uma referência ao WebPart controlo que está atualmente a ser editado.
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
Close()	Chamado quando um utilizador clica num verbo de fechar no cabeçalho de uma zona, este método termina o processo de edição WebPart de controlos e devolve o modo de visualização da página de Web Parts para o modo de navegação.
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateChildControls()	Cria o conjunto de controlos filhos associados a uma EditorZoneBase zona.
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateEditorPartChrome()	Obtém uma referência a um novo EditorPartChrome objeto usado para renderizar os elementos periféricos da interface de utilizador (UI) numa EditorZoneBase zona.
CreateEditorParts()	Fornece uma declaração base do método que as zonas derivadas podem sobrepor para tratar dos detalhes da criação dos EditorPart controlos contidos numa zona.
DataBind()	Vincula uma fonte de dados ao CompositeControl e a todos os seus controlos filhos. (Herdado de CompositeControl)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetEffectiveChromeType(Part)	Devolve o valor atual real ou efetivo PartChromeType de um WebPart controlo, dada a PartChromeType propriedade da zona e o modo de exibição atual da página Web Parts. (Herdado de WebZone)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
InvalidateEditorParts()	Define a coleção de EditorPart controlos associada a uma EditorZoneBase zona para `null`, o que resulta no CreateEditorParts() método ser chamado para recriar a coleção.
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Carrega informações de estado previamente guardadas para uma zona.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MergeStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Levanta o DisplayModeChanged evento e destrói todos EditorPart os controlos filhos na zona em preparação para que uma página Web entre ou saia do modo de visualização de edição.
OnInit(EventArgs)	Cria manipuladores de eventos especializados usados pelo WebPartManager controlo numa página Web. (Herdado de ToolZone)
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Aumenta o PreRender evento e chama o PerformPreRender() método para os elementos cromados dos EditorPart controlos.
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Eleva o SelectedWebPartChanged evento e define a EditorParts coleção para `null` na zona em preparação para um WebPart controlo entrar ou sair do modo de edição.
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RaisePostBackEvent(String)	Realiza as ações associadas a um dos verbos da zona, ou gera um evento que é publicado de volta ao servidor.
RecreateChildControls()	Recria o filho controla num controlo derivado de CompositeControl. (Herdado de CompositeControl)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza a zona para o objeto especificado HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Renderiza a tag HTML de abertura do controlo de zona para o objeto especificado HtmlTextWriter . (Herdado de WebZone)
RenderBody(HtmlTextWriter)	Sobrepõe-se ao método base para renderizar a área do corpo de uma zona derivada da EditorZoneBase classe.
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza todo o conteúdo de um controlo de zona entre as etiquetas de início e fim para o objeto especificado HtmlTextWriter . (Herdado de WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderFooter(HtmlTextWriter)	Sobrepõe o método base para renderizar verbos no rodapé de um ToolZone controlo. (Herdado de ToolZone)
RenderHeader(HtmlTextWriter)	Sobrepõe o método base para fornecer renderização especializada para a área do cabeçalho exigida pelos ToolZone controlos. (Herdado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Renderiza um verbo individual com um ToolZone controlo. (Herdado de ToolZone)
RenderVerbs(HtmlTextWriter)	Renderiza os verbos que se aplicam ao nível da zona.
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Guarda quaisquer alterações no estado de visualização que tenham ocorrido depois de uma página ter sido publicada de volta no servidor.
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Acompanha alterações ao estado de visão de um controlo de zona.

evento

Name	Description
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite ao designer recriar a coleção de controlos filhos do controlo composto no ambiente de design-time. (Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementa o RaisePostBackEvent(String) método. (Herdado de ToolZone)

Métodos da Extensão

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a recolha dos valores padrão para o controlo de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controlo de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Ver também

Comentários

Esta página foi útil?