EditorZone Classe

Definição

Serve como o controle principal no conjunto de controles de Web Parts para hospedar controles EditorPart em uma página da Web.

public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBase
public class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBase
type EditorZone = class
    inherit EditorZoneBase
Public Class EditorZone
Inherits EditorZoneBase
Herança

Exemplos

O exemplo de código a seguir demonstra vários usos declarativos e programáticos da EditorZone classe. O exemplo cria uma zona de editor personalizada que herda da classe e a EditorZone usa em uma página Web Parts.

O exemplo de código tem três partes:

  • Um controle de usuário que permite alterar os modos de exibição na página da Web.

  • Uma página da Web que faz referência ao controle personalizado EditorZone .

  • Uma explicação de como o exemplo funciona.

A primeira parte deste exemplo de código é o controle de usuário que permite que os usuários alterem os modos de exibição em uma página da Web. Para obter mais detalhes sobre modos de exibição e uma descrição do código-fonte nesse controle, consulte Passo a passo: Alterando modos de exibição em uma página Web Parts.

<%@ control language="C#" classname="DisplayModeMenuCS"%>

<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, 
    EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }
  
</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>

<script runat="server">
  
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager


Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs) 
    AddHandler Page.InitComplete, AddressOf InitComplete

End Sub 


Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs) 
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
    
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
    
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In  _manager.SupportedDisplayModes
        Dim modeName As String = mode.Name
        ' Make sure a mode is enabled before adding it.
        If mode.IsEnabled(_manager) Then
            Dim item As New ListItem(modeName + " Mode", modeName)
            DisplayModeDropdown.Items.Add(item)
        End If
    Next mode

End Sub 
 

' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) 
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue
    
    Dim mode As WebPartDisplayMode = _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
        _manager.DisplayMode = mode
    End If
 
End Sub 


Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs) 
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name

End Sub 

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

A segunda parte do exemplo de código é uma página da Web. Perto da parte superior da página há uma Register diretiva para o controle do usuário. A marca de controle do usuário é declarada na página com um uc1: prefixo para o elemento. Observe que abaixo do <asp:WebPartZone> elemento há um <asp:EditorZone> elemento que contém vários EditorPart controles, com algumas marcas e propriedades definidas para determinar sua aparência e comportamento. Há também vários métodos que acessam vários membros do EditorZone controle programaticamente.

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

  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled == true)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }

  void Button2_Click(object sender, EventArgs e)
  {
    EditorZone1.BorderWidth = 2;
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
  }

  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }

  void Button4_Click(object sender, EventArgs e)
  {
    EditorZone1.InstructionText = "My custom instruction text.";
  }
  // </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="mgr" 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>
    <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>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3>

  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled = True Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.BorderWidth = 2
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
  End Sub

  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

  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.InstructionText = "My custom instruction text."
  End Sub
  ' </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="mgr" 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>
    <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>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

Ao carregar a página em um navegador, você pode selecionar o 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 efeitos dos usos declarativos e programáticos dos membros da EditorZone classe.

Comentários

Dentro do conjunto de controle Web Parts, uma zona é um controle composto que abrange uma região definida em uma página da Web e contém controles de servidor. As principais funções de uma zona são definir os controles que ela contém e fornecer uma interface do usuário (interface do usuário) comum para esses controles. Para obter informações gerais sobre zonas e como elas são usadas em aplicativos Web Parts, consulte a documentação de referência da classe base WebZone e Web Parts Visão geral do Conjunto de Controle.

O EditorZone controle é um dos controles fundamentais no conjunto de controle Web Parts. Um dos principais recursos do Web Parts é a capacidade dos usuários finais de modificar (ou personalizar) páginas da Web de acordo com suas preferências e salvar suas configurações personalizadas para sessões futuras do navegador. Um aspecto da modificação Web Parts páginas inclui edição; os usuários podem editar a aparência, o layout, o comportamento e outras propriedades dos controles visíveisWebPart. Vários controles no conjunto de controle Web Parts fornecem os recursos de edição, incluindo o EditorZone controle.

Um EditorZone controle fica visível quando uma página Web Parts entra no modo de edição e disponibiliza vários EditorPart controles que podem ser usados para personalizar WebPart controles. O EditorZone controle é muito semelhante ao pai, a EditorZoneBase classe, com uma diferença fundamental: o EditorZone controle fornece um modelo de zona, referenciado em sua ZoneTemplate propriedade. O modelo de zona adiciona a capacidade de declarar conteúdo no formato de persistência de página. Os desenvolvedores de páginas podem colocar um EditorZone controle na marcação declarativa de uma página da Web, adicionar um elemento filho <zonetemplate> e, dentro do <zonetemplate> elemento, adicionar referências declarativas aos EditorPart controles.

O EditorZone controle também tem um método, CreateEditorPartsque substitui um método base na EditorZoneBase classe. Esse método é necessário para que um EditorZone controle possa criar o modelo de zona para conter todos EditorPart os controles adicionados à zona declarativamente.

Observação

Os botões na interface do EditorZone usuário exigem scripts do lado do cliente para funcionar corretamente. Se o script estiver desabilitado no navegador, o usuário não poderá executar ações por meio da interface do EditorZone usuário.

Acessibilidade

A marcação renderizada por padrão para esse controle pode não estar em conformidade com padrões de acessibilidade, como as diretrizes de prioridade 1.0 (Diretrizes de Acessibilidade de Conteúdo da Web) 1.0 (WCAG). Para obter detalhes sobre o suporte à acessibilidade para esse controle, consulte ASP.NET Controles e Acessibilidade.

Notas aos Herdeiros

Se você quiser criar uma zona personalizada EditorZone para obter maior controle sobre a renderização da interface do usuário de edição, poderá herdar diretamente da EditorZoneBase classe, desde que não precise fornecer suporte de modelo de zona para que os desenvolvedores de página adicionem EditorPart controles à sua zona declarativamente. Nesse caso, você adicionaria todos os EditorPart controles a uma zona programaticamente. Se você quiser fornecer suporte ao modelo de zona, herdará da EditorZone classe.

Construtores

EditorZone()

Inicializa uma nova instância da classe EditorZone.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.

(Herdado de Control)
ApplyVerb

Obtém uma referência a um objeto WebPartVerb que permite que os usuários finais apliquem alterações de edição em um controle no modo de edição.

(Herdado de EditorZoneBase)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.

(Herdado de Control)
AssociatedDisplayModes

Obtém a coleção de objetos WebPartDisplayMode associados a uma zona ToolZone específica.

(Herdado de ToolZone)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.

(Herdado de WebControl)
BackImageUrl

Obtém ou define a URL de uma imagem da tela de fundo para uma zona.

(Herdado de WebZone)
BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.

(Herdado de WebControl)
CancelVerb

Obtém uma referência a um objeto WebPartVerb que permite que os usuários finais cancelem alterações de edição em um controle no modo de edição.

(Herdado de EditorZoneBase)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.

(Herdado de Control)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém um objeto ControlCollection que representa os controles filho em um CompositeControl.

(Herdado de CompositeControl)
ControlStyle

Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.

(Herdado de Control)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
Display

Obtém um valor que indica se um controle ToolZone é exibido no momento.

(Herdado de EditorZoneBase)
EditorPartChrome

Obtém uma referência à instância da classe EditorPartChrome associada à zona de EditorZoneBase.

(Herdado de EditorZoneBase)
EditorParts

Obtém uma coleção de todos os controles EditorPart contidos em uma zona EditorZoneBase.

(Herdado de EditorZoneBase)
EditUIStyle

Obtém os atributos de estilo para os controles editáveis contidos em um controle ToolZone.

(Herdado de ToolZone)
EmptyZoneText

Obtém ou define uma mensagem que aparece quando uma zona não contém nenhum controle.

(Herdado de EditorZoneBase)
EmptyZoneTextStyle

Obtém os atributos de estilo para o texto de espaço reservado em uma zona vazia.

(Herdado de WebZone)
Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.

(Herdado de WebControl)
EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.

(Herdado de Control)
ErrorStyle

Obtém os atributos de estilo para renderizar a mensagem de erro que será exibida se um controle WebPart não puder ser carregado ou criado.

(Herdado de WebZone)
ErrorText

Obtém ou define o texto de uma mensagem de erro de nível de zona para exibir na parte superior da interface do usuário de edição.

(Herdado de EditorZoneBase)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.

(Herdado de WebControl)
FooterStyle

Obtém os atributos de estilo para o conteúdo da área de rodapé da zona.

(Herdado de WebZone)
ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.

(Herdado de WebControl)
HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.

(Herdado de Control)
HasFooter

Obtém um valor que indica se uma zona tem uma área de rodapé.

(Herdado de WebZone)
HasHeader

Obtém um valor que indica se uma zona tem uma área de cabeçalho.

(Herdado de WebZone)
HeaderCloseVerb

Obtém uma referência ao objeto WebPartVerb no cabeçalho de um controle ToolZone que é usado para fechar o controle.

(Herdado de ToolZone)
HeaderStyle

Obtém os atributos de estilo para o conteúdo da área do cabeçalho da zona.

(Herdado de WebZone)
HeaderText

Obtém ou define o texto para a área do cabeçalho de uma zona.

(Herdado de EditorZoneBase)
HeaderVerbStyle

Obtém os atributos de estilo para todos os verbos de cabeçalho exibidos em um controle ToolZone.

(Herdado de ToolZone)
Height

Obtém ou define a altura do controle do servidor Web.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
InstructionText

Obtém ou define o texto em um controle ToolZone que fornece orientações para os usuários finais.

(Herdado de EditorZoneBase)
InstructionTextStyle

Obtém os atributos de estilo para o texto de instrução exibido na parte superior de um controle ToolZone.

(Herdado de ToolZone)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.

(Herdado de Control)
IsEnabled

Obtém um valor que indica se o controle está habilitado.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.

(Herdado de Control)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(Herdado de Control)
LabelStyle

Obtém os atributos de estilo para o conteúdo dos rótulos exibidos junto com os controles de edição dentro de um controle ToolZone. Os controles ToolZone derivados, como CatalogZone e EditorZone, aplicam os estilos aos rótulos.

(Herdado de ToolZone)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.

(Herdado de Control)
OKVerb

Obtém uma referência a um objeto WebPartVerb que aplica as alterações de edição a um controle no modo de edição e oculta a interface do usuário de edição.

(Herdado de EditorZoneBase)
Padding

Obtém ou define os atributos de preenchimento de célula em uma tabela que contém o controles WebPart em uma zona.

(Herdado de WebZone)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.

(Herdado de Control)
PartChromePadding

Obtém ou define a distância entre o conteúdo de um controle WebPart e a borda do controle.

(Herdado de WebZone)
PartChromeStyle

Obtém as características de estilo que se aplicam às bordas dos controles de Web Parts contidos por uma zona.

(Herdado de WebZone)
PartChromeType

Obtém ou define o tipo de borda que emoldura os controles de Web Parts contidos por uma zona.

(Herdado de WebZone)
PartStyle

Obtém as características de estilo que se aplicam às bordas e ao conteúdo de cada controle de Web Parts contido por uma zona.

(Herdado de WebZone)
PartTitleStyle

Obtém os atributos de estilo do conteúdo da barra de título de cada controle de Web Parts contido por uma zona.

(Herdado de WebZone)
RenderClientScript

Obtém um valor que indica se o script de cliente em uma página de Web Parts deve ser renderizado.

(Herdado de WebZone)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.

(Herdado de CompositeControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.

(Herdado de WebControl)
TagKey

Obtém o valor HtmlTextWriterTag que corresponde ao controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebZone)
TagName

Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.

(Herdado de Control)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
VerbButtonType

Obtém ou define o tipo de botão usado para representar verbos em uma zona.

(Herdado de WebZone)
VerbStyle

Obtém os atributos de estilo para os verbos da UI (interface do usuário) associados aos controles de Web Parts em uma zona.

(Herdado de WebZone)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como um elemento da interface do usuário na página.

(Herdado de ToolZone)
WebPartManager

Obtém uma referência para o controle WebPartManager associado a uma instância do controle WebZone em uma página de Web Parts.

(Herdado de WebZone)
WebPartToEdit

Obtém uma referência para o controle WebPart que está sendo editado no momento.

(Herdado de EditorZoneBase)
Width

Obtém ou define a largura do controle de servidor Web.

(Herdado de WebControl)
ZoneTemplate

Fornece um modelo para conter controles filho dentro de um controle EditorZone no formato de persistência de página.

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.

(Herdado de Control)
Close()

Chamado quando um usuário clica em um verbo fechar no cabeçalho de uma zona, esse método encerra o processo de edição de controles WebPart e retorna um modo de exibição da página de Web Parts para o modo de navegação.

(Herdado de EditorZoneBase)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateChildControls()

Cria o conjunto de controles filho associados a uma zona EditorZoneBase.

(Herdado de EditorZoneBase)
CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateEditorPartChrome()

Obtém uma referência a um novo objeto EditorPartChrome usado para renderizar os elementos da interface do usuário periférica em torno da zona EditorZoneBase.

(Herdado de EditorZoneBase)
CreateEditorParts()

Cria todos os controles EditorPart declarados dentro de um modelo de zona no formato de persistência de página.

DataBind()

Associa uma fonte de dados ao CompositeControl e a todos os seus controles filho.

(Herdado de CompositeControl)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.

(Herdado de Control)
EnsureID()

Cria um identificador para controles 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)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.

(Herdado de Control)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.

(Herdado de Control)
GetEffectiveChromeType(Part)

Retorna o valor PartChromeType atual real ou efetivo de um controle WebPart, considerando a propriedade PartChromeType da zona e o modo de exibição atual da página de Web Parts.

(Herdado de WebZone)
GetHashCode()

Serve como a função de hash padrão.

(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 a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.

(Herdado de Control)
InvalidateEditorParts()

Define a coleção de controles EditorPart associados a uma zona EditorZoneBase como null, o que resulta no método CreateEditorParts() sendo chamado para recriar a coleção.

(Herdado de EditorZoneBase)
IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState().

(Herdado de Control)
LoadViewState(Object)

Carrega informações de estado salvas anteriormente para uma zona.

(Herdado de EditorZoneBase)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.

(Herdado de Control)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Gera o evento DisplayModeChanged e destrói todos os EditorPart e controles filho na zona na preparação para uma página da Web para entrar ou sair do modo de exibição de edição.

(Herdado de EditorZoneBase)
OnInit(EventArgs)

Cria manipuladores de eventos especializados usados pelo controle WebPartManager em uma página da Web.

(Herdado de ToolZone)
OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnPreRender(EventArgs)

Gera o evento PreRender e chama o método PerformPreRender() para os elementos cromados dos controles EditorPart.

(Herdado de EditorZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Gera o evento SelectedWebPartChanged e define a coleção EditorParts como null na zona no preparo para um controle WebPart entrar ou sair do modo de edição.

(Herdado de EditorZoneBase)
OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.

(Herdado de Control)
RaisePostBackEvent(String)

Executa as ações associadas a um dos verbos de zona ou aciona um evento que é enviado de volta para o servidor.

(Herdado de EditorZoneBase)
RecreateChildControls()

Recria os controles filho em um controle derivado de CompositeControl.

(Herdado de CompositeControl)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.

(Herdado de Control)
Render(HtmlTextWriter)

Renderiza a zona para o objeto de HtmlTextWriter especificado.

(Herdado de EditorZoneBase)
RenderBeginTag(HtmlTextWriter)

Renderiza a marca HTML de abertura do controle de zona para o objeto HtmlTextWriter especificado.

(Herdado de WebZone)
RenderBody(HtmlTextWriter)

Substitui o método base para renderizar a área do corpo de uma zona derivada da classe EditorZoneBase.

(Herdado de EditorZoneBase)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza todo o conteúdo de um controle de zona entre as marcas inicial e final no objeto HtmlTextWriter especificado.

(Herdado de WebZone)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderFooter(HtmlTextWriter)

Substitui o método base para renderizar verbos no rodapé de um controle ToolZone.

(Herdado de ToolZone)
RenderHeader(HtmlTextWriter)

Substitui o método base para fornecer renderização especializada para a área de cabeçalho necessária para os controles ToolZone.

(Herdado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Renderiza um verbo individual com um controle ToolZone.

(Herdado de ToolZone)
RenderVerbs(HtmlTextWriter)

Renderiza os verbos que se aplicam no nível de zona.

(Herdado de EditorZoneBase)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.

(Herdado de Control)
SaveViewState()

Salva as alterações de estado de exibição que ocorreram após o postback da página no servidor.

(Herdado de EditorZoneBase)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Controla as alterações no estado de exibição do controle de uma zona.

(Herdado de EditorZoneBase)

Eventos

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.

(Herdado de Control)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controle de servidor é carregado no objeto Page.

(Herdado de Control)
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle da Web para o nome e o valor especificados.

(Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permite que um designer recrie a coleção de controles filho do controle de composição no ambiente de tempo de design.

(Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).

(Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa o método RaisePostBackEvent(String).

(Herdado de ToolZone)

Métodos de Extensão

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

Aplica-se a

Confira também