WebPartZone 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 o controlo principal no conjunto de controlos Web Parts para hospedagem WebPart de controlos numa página Web.

public ref class WebPartZone : System::Web::UI::WebControls::WebParts::WebPartZoneBase

public class WebPartZone : System.Web.UI.WebControls.WebParts.WebPartZoneBase

type WebPartZone = class
    inherit WebPartZoneBase

Public Class WebPartZone
Inherits WebPartZoneBase

Herança: Object

Control

WebControl

CompositeControl

WebZone

WebPartZoneBase
WebPartZone

Exemplos

O exemplo de código seguinte demonstra o uso do WebPartZone controlo numa página de Web Parts. 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. 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.

A primeira parte do exemplo mostra uma classe personalizada que herda da WebPartZone classe, e que define duas das propriedades da zona base no construtor.

using System;
using System.Collections;
using System.ComponentModel;
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 MyWebPartZone : WebPartZone
  {
    public MyWebPartZone()
    {
      base.VerbButtonType = ButtonType.Button;
      base.CloseVerb.Enabled = false;
    }
  }
}

Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.WebControls
Imports System.Web.UI
Imports System.Web
Imports System.Security.Permissions
Imports System.ComponentModel
Imports System.Collections
Namespace Samples.AspNet.VB.Controls
  

<AspNetHostingPermission(SecurityAction.Demand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class MyWebPartZone
  Inherits WebPartZone
  
  Public Sub New()
    MyBase.New
    MyBase.VerbButtonType = ButtonType.Button
    MyBase.CloseVerb.Enabled = false
  End Sub
End Class
  
End Namespace

A segunda parte do exemplo mostra uma página que contém o controlo personalizado WebPartZone . Note que a página requer uma diretiva especial Register perto do topo da página para referenciar o conjunto que contém a zona personalizada. A página também contém um <asp:webpartmanager> elemento, que é obrigatório em todas as páginas de Web Parts. O elemento <cc1:MyWebPartZone>, que representa o controlo personalizado WebPartZone, contém um controlo padrão ASP.NET Calendar. Como está contido numa WebPartZone zona, o Calendar controlo será envolto com um GenericWebPart controlo em tempo de execução, o que lhe permite atuar como controlo WebPart .

<%@ Page Language="C#" %>
<%@ Register TagPrefix="cc1" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="MyWebPartZoneCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server" />
      <cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
        <VerbStyle Font-Italic="true" />
        <PartChromeStyle BackColor="lightblue" />
        <PartStyle BackColor="gray" />
        <PartTitleStyle Font-Bold="true" />
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </cc1:MyWebPartZone>
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register TagPrefix="cc1" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="MyWebPartZoneVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" runat="server" />
      <cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
        <VerbStyle Font-Italic="true" />
        <PartChromeStyle BackColor="lightblue" />
        <PartStyle BackColor="gray" />
        <PartTitleStyle Font-Bold="true" />
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </cc1:MyWebPartZone>
    </div>
    </form>
</body>
</html>

Verifique a marcação declarativa para o controlo personalizado WebPartZone . Note que pode definir várias propriedades ao nível da zona na marcação, como mostrado no seguinte exemplo de código.

Note

É muito importante notar o uso do <zonetemplate> elemento. Este elemento, conforme descrito na secção de Observações, é necessário dentro de uma WebPartZone zona para envolver os controlos estáticos WebPart que são declarados numa página.

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

<cc1:MyWebPartZone ID="MyWebPartZone1" runat="server">
  <VerbStyle Font-Italic="true" />
  <PartChromeStyle BackColor="lightblue" />
  <PartStyle BackColor="gray" />
  <PartTitleStyle Font-Bold="true" />
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server" 
      Title="My Calendar" />
  </ZoneTemplate>
</cc1:MyWebPartZone>

Observações

Na funcionalidade Web Parts, uma zona é uma região definida numa página Web que contém controlos Web Parts. As funções principais de uma zona são dispor os controlos que contém e fornecer uma interface de utilizador (UI) comum para esses controlos. Para informações gerais sobre zonas e como são usadas em aplicações Web Parts, consulte a documentação de referência para a base WebZone e WebPartZoneBase as classes, e o tópico intitulado Web Parts Control Set Overview.

A função especial do WebPartZone controlo é conter WebPart controlos, que formam a interface principal das aplicações Web Parts. Um controlo pode ser declarado em formato de persistência numa página Web, permitindo aos WebPartZone programadores usá-lo como modelo e adicionar outros controlos de servidor dentro do <asp:webpartzone> elemento. Qualquer tipo de controlo de servidor, se adicionado a uma WebPartZone zona, pode funcionar como WebPart controlo em tempo de execução. Isto é verdade independentemente de o controlo adicional ser um controlo WebPart, um controlo de utilizador, um controlo personalizado ou um controlo ASP.NET. Para mais informações, consulte o tema da GenericWebPart disciplina.

Para além de conter WebPart controlos, um WebPartZone controlo também fornece uma interface comum para os controlos que contém. Esta interface comum, conhecida coletivamente como chrome, consiste nos elementos periféricos da interface em todos os controlos, como a borda, título, cabeçalho e rodapé, características de estilo e verbos (ações da interface que um utilizador pode realizar num controlo, como fechar ou minimizar).

Note

Internet Explorer pode renderizar a altura de um WebPartZone ou dos seus controlos contidos de forma inesperada, dependendo da orientação da zona. Para mais detalhes, consulte a documentação das LayoutOrientation ou das Height propriedades.

A WebPartZone classe deriva a maior parte do seu comportamento da base WebZone e WebPartZoneBase das classes; acrescenta apenas um membro único, a ZoneTemplate propriedade. Esta propriedade faz referência a um ITemplate objeto, que é um modelo que permite aos programadores de páginas definir os controlos numa zona de forma estática, usando um <zonetemplate> elemento na marcação declarativa de uma página .aspx.

Accessibility

A marcação apresentada por defeito para este controlo pode não estar em conformidade com normas de acessibilidade, como as diretrizes de prioridade 1 da Web Content Accessibility Guidelines 1.0 (WCAG). Para detalhes sobre o suporte de acessibilidade para este controlo, consulte ASP.NET Controlos e Acessibilidade.

Construtores

Name	Description
WebPartZone()	Inicializa uma nova instância da WebPartZone classe.

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)
AllowLayoutChange	Recebe ou define um valor que indica se a disposição dos WebPart controlos pode ser alterada dentro de uma zona. (Herdado de WebPartZoneBase)
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)
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 para a borda de um WebPartZoneBase controlo. (Herdado de WebPartZoneBase)
BorderStyle	Consegue ou define o tipo de fronteira que rodeia um WebPartZoneBase controlo. (Herdado de WebPartZoneBase)
BorderWidth	Obtém ou define a largura da fronteira que rodeia um WebPartZoneBase controlo. (Herdado de WebPartZoneBase)
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)
CloseVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais fechar os WebPart controlos numa zona. (Herdado de WebPartZoneBase)
ConnectVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais criar ligações entre WebPart controlos. (Herdado de WebPartZoneBase)
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)
DeleteVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais eliminar os WebPart controlos numa zona. (Herdado de WebPartZoneBase)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
DisplayTitle	Obtém o valor atual do texto usado como título de uma WebPartZoneBase zona quando a própria zona está visível. (Herdado de WebPartZoneBase)
DragDropEnabled	Recebe um valor que indica se WebPart os controlos podem ser arrastados para dentro ou para fora de uma zona. (Herdado de WebPartZoneBase)
DragHighlightColor	Obtém ou define a cor em torno da borda de uma WebPartZoneBase zona e das suas regiões de drop-cue quando um utilizador arrasta um controlo. (Herdado de WebPartZoneBase)
EditVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais editar WebPart os controlos numa zona. (Herdado de WebPartZoneBase)
EmptyZoneText	Recebe ou define uma mensagem que aparece quando um WebPartZoneBase controlo não contém controlos WebPart . (Herdado de WebPartZoneBase)
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)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
ExportVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais exportar um ficheiro de definição XML para cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
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 WebPartZoneBase)
HasHeader	Recebe um valor que indica se uma zona tem uma área de cabeçalho. (Herdado de WebPartZoneBase)
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. (Herdado de WebZone)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl)
HelpVerb	Obtém uma referência a um WebPartVerb objeto usado para aceder a conteúdos de Ajuda para WebPart controlos numa zona. (Herdado de WebPartZoneBase)
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)
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)
LayoutOrientation	Recebe ou define um valor que indica se os controlos numa zona estão dispostos vertical ou horizontalmente. (Herdado de WebPartZoneBase)
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)
MenuCheckImageStyle	Obtém atributos de estilo que são aplicados à imagem da marca de verificação que aparece num menu de verbos ao lado do texto verbal selecionado. (Herdado de WebPartZoneBase)
MenuCheckImageUrl	Recebe ou define a URL para uma imagem usada como marca de verificação no menu de verbos de cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
MenuLabelHoverStyle	Obtém atributos de estilo que são aplicados ao rótulo de um menu de verbos na barra de título de um WebPart controlo quando um utilizador posiciona o ponteiro do rato sobre o rótulo. (Herdado de WebPartZoneBase)
MenuLabelStyle	Obtém informação de estilo para o menu suspenso de rótulo dos verbos que aparece na barra de título de cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
MenuLabelText	Recebe ou define o valor que serve de rótulo para o menu suspenso de verbos na barra de título de cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
MenuPopupImageUrl	Recebe ou define a URL para uma imagem que abre o menu suspenso de verbos na barra de título de cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
MenuPopupStyle	Obtém atributos de estilo para o menu suspenso de verbos que aparece nos WebPart controlos de uma zona. (Herdado de WebPartZoneBase)
MenuVerbHoverStyle	Obtém informação de estilo para a aparência de um verbo num menu suspenso de verbos quando o utilizador final posiciona o ponteiro do rato sobre o verbo. (Herdado de WebPartZoneBase)
MenuVerbStyle	Obtém informação de estilo para a aparência de um verbo num menu suspenso de verbos quando o menu é exibido. (Herdado de WebPartZoneBase)
MinimizeVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais minimizar WebPart os controlos numa zona. (Herdado de WebPartZoneBase)
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)
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)
RestoreVerb	Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais restaurar WebPart os controlos numa zona ao tamanho normal. (Herdado de WebPartZoneBase)
SelectedPartChromeStyle	Obtém informação de estilo para a aparência de um controlo selecionado WebPart numa zona. (Herdado de WebPartZoneBase)
ShowTitleIcons	Recebe ou define um valor que indica se os ícones de título são exibidos na barra de título de cada WebPart controlo numa zona. (Herdado de WebPartZoneBase)
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)
TitleBarVerbButtonType	Obtém ou define o tipo de botão usado para os verbos na barra de título dos WebPart controlos. (Herdado de WebPartZoneBase)
TitleBarVerbStyle	Obtém atributos de estilo para verbos na barra de título de um WebPart controlo. (Herdado de WebPartZoneBase)
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 o tipo de botão associado aos verbos que existem numa WebPartZoneBase zona quando acedidos por um navegador antigo. (Herdado de WebPartZoneBase)
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 UI na página. (Herdado de Control)
WebPartChrome	Obtém uma referência ao WebPartChrome objeto que determina a renderização periférica dos WebPart controlos na zona. (Herdado de WebPartZoneBase)
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)
WebParts	Obtém a coleção de controlos de Web Parts contida dentro de uma zona. (Herdado de WebPartZoneBase)
WebPartVerbRenderMode	Recebe ou define um valor que indica como os verbos devem ser renderizados nos WebPart controlos da zona. (Herdado de WebPartZoneBase)
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl)
ZoneTemplate	Obtém ou define uma referência para uma ITemplate instância que contém os controlos declarados na marcação de uma página Web.

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)
CloseWebPart(WebPart)	Fecha um controlo selecionado WebPart numa zona. (Herdado de WebPartZoneBase)
ConnectWebPart(WebPart)	Inicia o processo de criação de uma ligação entre dois WebPart controlos. (Herdado de WebPartZoneBase)
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 contidos numa zona. (Herdado de WebPartZoneBase)
CreateControlCollection()	Cria um ControlCollection objeto que contém todos os controlos de uma zona. (Herdado de WebPartZoneBase)
CreateControlStyle()	Cria um conjunto de características de estilo que se aplicam a um controlo de zona quando este é visível. (Herdado de WebPartZoneBase)
CreateWebPartChrome()	Permite que zonas derivadas substituam um objeto personalizado WebPartChrome para alterar a aparência dos WebPart controlos numa zona. (Herdado de WebPartZoneBase)
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)
DeleteWebPart(WebPart)	Elimina um controlo selecionado WebPart numa zona. (Herdado de WebPartZoneBase)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EditWebPart(WebPart)	Inicia o processo de edição de um controlo selecionado WebPart numa zona. (Herdado de WebPartZoneBase)
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 WebPartZoneBase)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetInitialWebParts()	Sobrepõe o método base abstrato e obtém o conjunto inicial de controlos estáticos WebPart contidos no template da zona.
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)
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. (Herdado de WebPartZoneBase)
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)
MinimizeWebPart(WebPart)	Minimiza um controlo selecionado WebPart numa zona. (Herdado de WebPartZoneBase)
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)
OnCreateVerbs(WebPartVerbsEventArgs)	Eleva o CreateVerbs evento. (Herdado de WebPartZoneBase)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnInit(EventArgs)	Sobrepõe o método base para indicar que a zona foi registada com sucesso junto do WebPartManager controlo.
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de WebPartZoneBase)
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)	Atualiza o estado da coleção atual de WebPart controlos numa zona, com base nas alterações ocorridas desde o evento postback mais recente. (Herdado de WebPartZoneBase)
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 . (Herdado de WebPartZoneBase)
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 WebPartZoneBase classe. (Herdado de WebPartZoneBase)
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)
RenderDropCue(HtmlTextWriter)	Renderiza elementos da interface de utilizador (UI) para indicar ao utilizador final onde um WebPart controlo que está a ser arrastado pode ser largado dentro de uma zona. (Herdado de WebPartZoneBase)
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 a renderização do rodapé de um controlo de zona. (Herdado de WebZone)
RenderHeader(HtmlTextWriter)	Sobrepõe o método base para renderizar o cabeçalho de uma WebPartZoneBase zona que contém WebPart controlos. (Herdado de WebPartZoneBase)
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)
RestoreWebPart(WebPart)	Restaura um controlo selecionado WebPart que foi minimizado para o estado normal. (Herdado de WebPartZoneBase)
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. (Herdado de WebPartZoneBase)
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()	Inicia o processo de acompanhar alterações de estado de visualização numa zona para que possam ser armazenadas num StateBag objeto e acedidas através da ViewState propriedade. (Herdado de WebPartZoneBase)

evento

Name	Description
CreateVerbs	Ocorre quando os verbos são criados para uma zona que deriva da WebPartZoneBase classe. (Herdado de WebPartZoneBase)
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)	Para uma descrição deste elemento, veja RaisePostBackEvent(String). (Herdado de WebPartZoneBase)

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?