WebPartZone Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Serve como o controle principal no conjunto de controles de Web Parts para hospedar controles WebPart em uma página da Web.
public ref class WebPartZone : System::Web::UI::WebControls::WebParts::WebPartZoneBasepublic class WebPartZone : System.Web.UI.WebControls.WebParts.WebPartZoneBasetype WebPartZone = class
inherit WebPartZoneBasePublic Class WebPartZone
Inherits WebPartZoneBase- Herança
Exemplos
O exemplo de código a seguir demonstra o uso do WebPartZone controle em uma página de Web Parts. Para que o exemplo de código seja executado, você deve compilar esse código-fonte. Você pode compilá-lo explicitamente e colocar o assembly resultante na pasta Bin do site ou no cache de assembly global. Como alternativa, você pode colocar o código-fonte na pasta App_Code do site, na qual ele será compilado dinamicamente em tempo de execução. Para obter um passo a passo que demonstra os dois métodos de compilação, consulte Passo a passo : desenvolvendo e usando um controle 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 controle personalizado WebPartZone . Observe que a página requer uma diretiva especial Register perto da parte superior da página para fazer referência ao assembly que contém a zona personalizada. A página também contém um <asp:webpartmanager> elemento , que é necessário em todas as páginas de Web Parts. O <cc1:MyWebPartZone> elemento , que representa o controle personalizado WebPartZone , contém um controle de ASP.NET Calendar padrão. Como ele está contido em uma WebPartZone zona, o Calendar controle será encapsulado com um GenericWebPart controle em tempo de execução, o que permite que ele atue como um WebPart controle.
<%@ 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>
Examine a marcação declarativa para o controle personalizado WebPartZone . Observe que você pode definir várias propriedades de nível de zona na marcação, conforme mostrado no exemplo de código a seguir.
Observação
É muito importante observar o uso do <zonetemplate> elemento . Esse elemento, conforme descrito na seção Comentários, é necessário dentro de uma WebPartZone zona para encapsular os controles estáticos WebPart declarados em uma 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>
Comentários
No recurso Web Parts, uma zona é uma região definida em uma página da Web que contém controles de Web Parts. As principais funções de uma zona são definir os controles que ela contém e fornecer uma interface do usuário comum para esses controles. Para obter informações gerais sobre zonas e como elas são usadas em aplicativos de Web Parts, consulte a documentação de referência para as classes base WebZone e WebPartZoneBase e o tópico intitulado Visão geral do conjunto de controle de Web Parts.
A função especial do WebPartZone controle é conter WebPart controles, que formam a interface do usuário main de aplicativos web parts. Um WebPartZone controle pode ser declarado no formato de persistência em uma página da Web, permitindo que os desenvolvedores o usem como modelo e adicionem outros controles de servidor dentro do <asp:webpartzone> elemento . Qualquer tipo de controle de servidor, se adicionado a uma WebPartZone zona, pode funcionar como um WebPart controle em tempo de execução. Isso é verdadeiro independentemente de o controle adicionado ser um WebPart controle, um controle de usuário, um controle personalizado ou um controle ASP.NET. Para obter mais informações, consulte o tópico da GenericWebPart classe .
Além de conter WebPart controles, um WebPartZone controle também fornece uma interface do usuário comum para os controles que ele contém. Essa interface do usuário comum, conhecida coletivamente como cromo, consiste nos elementos de interface do usuário periféricos em todos os controles, como borda, título, cabeçalho e rodapé, características de estilo e verbos (ações de interface do usuário que um usuário pode executar em um controle, como fechar ou minimizar).
Observação
Os Explorer da Internet podem renderizar a altura de um WebPartZone ou seus controles contidos de maneira inesperada, dependendo da orientação da zona. Para obter mais detalhes, consulte a documentação das LayoutOrientation propriedades ou Height .
A WebPartZone classe deriva a maior parte de seu comportamento da base WebZone e WebPartZoneBase das classes ; ela adiciona apenas um membro exclusivo, a ZoneTemplate propriedade . Essa propriedade faz referência a um ITemplate objeto , que é um modelo que permite que os desenvolvedores de página definam os controles em uma zona estaticamente usando um <zonetemplate> elemento na marcação declarativa de uma página .aspx.
Acessibilidade
A marcação renderizada por padrão para esse controle pode não estar em conformidade com os padrões de acessibilidade, como as diretrizes de prioridade 1.0 (WCAG) das Diretrizes de Acessibilidade de Conteúdo da Web 1.0 (WCAG). Para obter detalhes sobre o suporte de acessibilidade para esse controle, consulte Controles de ASP.NET e Acessibilidade.
Construtores
| WebPartZone() |
Inicializa uma nova instância da classe WebPartZone. |
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) |
| AllowLayoutChange |
Obtém ou define um valor que indica se o layout dos controles WebPart pode ser alterado dentro de uma zona. (Herdado de WebPartZoneBase) |
| 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) |
| 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 de um controle WebPartZoneBase. (Herdado de WebPartZoneBase) |
| BorderStyle |
Obtém ou define o tipo de borda ao redor de um controle WebPartZoneBase. (Herdado de WebPartZoneBase) |
| BorderWidth |
Obtém ou define a largura da borda ao redor de um controle WebPartZoneBase. (Herdado de WebPartZoneBase) |
| 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) |
| CloseVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais fechar os controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| ConnectVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais criar conexões entre os controles WebPart. (Herdado de WebPartZoneBase) |
| 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) |
| DeleteVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais excluir os controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| DisplayTitle |
Obtém o valor atual do texto que está sendo usado como o título de uma zona WebPartZoneBase quando ela está visível. (Herdado de WebPartZoneBase) |
| DragDropEnabled |
Obtém um valor que indica se os controles WebPart podem ser arrastados para dentro ou para fora de uma zona. (Herdado de WebPartZoneBase) |
| DragHighlightColor |
Obtém ou define a cor ao redor da borda de uma zona WebPartZoneBase e suas regiões de sinalização de soltar quando um usuário está arrastando um controle. (Herdado de WebPartZoneBase) |
| EditVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais editar os controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| EmptyZoneText |
Obtém ou define uma mensagem exibida quando um controle WebPartZoneBase não contém controles WebPart. (Herdado de WebPartZoneBase) |
| 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) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| ExportVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais exportar um arquivo de definição XML para cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| 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 WebPartZoneBase) |
| HasHeader |
Obtém 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 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 WebZone) |
| Height |
Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl) |
| HelpVerb |
Obtém uma referência a um objeto WebPartVerb usado para acessar o conteúdo de Ajuda para controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| 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) |
| 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) |
| LayoutOrientation |
Obtém ou define um valor que indica se os controles em uma zona estão dispostos vertical ou horizontalmente. (Herdado de WebPartZoneBase) |
| 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) |
| MenuCheckImageStyle |
Obtém os atributos de estilo aplicados à imagem de marca de seleção exibida em um menu de verbos ao lado do texto do verbo selecionado. (Herdado de WebPartZoneBase) |
| MenuCheckImageUrl |
Obtém ou define a URL para uma imagem usada como marca de seleção no menu de verbos de cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| MenuLabelHoverStyle |
Obtém atributos estilo aplicados ao rótulo de um menu de verbos na barra de título de um controle WebPart quando um usuário posiciona o ponteiro do mouse sobre o rótulo. (Herdado de WebPartZoneBase) |
| MenuLabelStyle |
Obtém informações de estilo para o rótulo do menu suspenso de verbos exibido na barra de título de cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| MenuLabelText |
Obtém ou define o valor que funciona como um rótulo para o menu suspenso de verbos na barra de título de cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| MenuPopupImageUrl |
Obtém ou define a URL para uma imagem que abre o menu suspenso de verbos na barra de título de cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| MenuPopupStyle |
Obtém atributos de estilo para o menu de verbos suspenso exibido nos controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| MenuVerbHoverStyle |
Obtém informações de estilo para a aparência de um verbo em um menu suspenso de verbos quando um usuário final posiciona o ponteiro do mouse sobre o verbo. (Herdado de WebPartZoneBase) |
| MenuVerbStyle |
Obtém informações de estilo para a aparência de um verbo em um menu suspenso de verbos quando o menu é exibido. (Herdado de WebPartZoneBase) |
| MinimizeVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais minimizar os controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| 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) |
| 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) |
| RestoreVerb |
Obtém uma referência a um objeto WebPartVerb que permite aos usuários finais restaurar os controles WebPart em uma zona para o tamanho normal. (Herdado de WebPartZoneBase) |
| SelectedPartChromeStyle |
Obtém informações de estilo para a aparência de um controle WebPart selecionado em uma zona. (Herdado de WebPartZoneBase) |
| ShowTitleIcons |
Obtém ou define um valor que indica se os ícones de título são exibidos na barra de título de cada controle WebPart em uma zona. (Herdado de WebPartZoneBase) |
| 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 |
| 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) |
| TitleBarVerbButtonType |
Obtém ou define o tipo de botão usado para os verbos na barra de título dos controles WebPart. (Herdado de WebPartZoneBase) |
| TitleBarVerbStyle |
Obtém atributos de estilo para verbos na barra de título de um controle WebPart. (Herdado de WebPartZoneBase) |
| 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 associado aos verbos que existem em uma zona WebPartZoneBase quando acessados com um navegador mais antigo. (Herdado de WebPartZoneBase) |
| 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 uma interface do usuário na página. (Herdado de Control) |
| WebPartChrome |
Obtém uma referência ao objeto WebPartChrome que determina a renderização periférica para controles WebPart na zona. (Herdado de WebPartZoneBase) |
| 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) |
| WebParts |
Obtém a coleção de controles de Web Parts contidos dentro de uma zona. (Herdado de WebPartZoneBase) |
| WebPartVerbRenderMode |
Obtém ou define um valor que indica como os verbos devem ser renderizados em controles WebPart na zona. (Herdado de WebPartZoneBase) |
| Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl) |
| ZoneTemplate |
Obtém ou define uma referência para uma instância de ITemplate que contém os controles declarados na marcação de uma página da Web. |
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 |
| 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) |
| CloseWebPart(WebPart) |
Fecha um controle WebPart selecionado em uma zona. (Herdado de WebPartZoneBase) |
| ConnectWebPart(WebPart) |
Inicia o processo de criação de uma conexão entre dois controles WebPart. (Herdado de WebPartZoneBase) |
| 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 contidos em uma zona. (Herdado de WebPartZoneBase) |
| CreateControlCollection() |
Cria um objeto ControlCollection que contém todos os controles em uma zona. (Herdado de WebPartZoneBase) |
| CreateControlStyle() |
Cria um conjunto de características de estilo aplicadas a um controle de zona, quando ele está visível. (Herdado de WebPartZoneBase) |
| CreateWebPartChrome() |
Permite que zonas derivadas substituam um objeto WebPartChrome personalizado para alterar a aparência dos controles WebPart em uma zona. (Herdado de WebPartZoneBase) |
| 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) |
| DeleteWebPart(WebPart) |
Exclui um controle WebPart selecionado em uma zona. (Herdado de WebPartZoneBase) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
| EditWebPart(WebPart) |
Inicia o processo de edição de um controle WebPart selecionado em uma zona. (Herdado de WebPartZoneBase) |
| 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 |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| 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 WebPartZoneBase) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetInitialWebParts() |
Substitui o método base abstrato e obtém o conjunto inicial de controles WebPart estáticos contidos no modelo 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 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) |
| 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 WebPartZoneBase) |
| 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) |
| MinimizeWebPart(WebPart) |
Minimiza um controle WebPart selecionado em uma zona. (Herdado de WebPartZoneBase) |
| 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) |
| OnCreateVerbs(WebPartVerbsEventArgs) |
Aciona o evento CreateVerbs. (Herdado de WebPartZoneBase) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Substitui o método base para indicar que a zona foi registrada com êxito no controle WebPartManager. |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de WebPartZoneBase) |
| 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) |
Atualiza o status da coleção atual de controles WebPart em uma zona, com base nas alterações que ocorreram desde o evento de postback mais recente. (Herdado de WebPartZoneBase) |
| 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 WebPartZoneBase) |
| 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 WebPartZoneBase. (Herdado de WebPartZoneBase) |
| 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) |
| RenderDropCue(HtmlTextWriter) |
Renderiza elementos de IU (interface do usuário) a serem indicados para um usuário final em que um controle WebPart que está sendo arrastado pode ser solto dentro de uma zona. (Herdado de WebPartZoneBase) |
| 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 a renderização do rodapé de um controle de zona. (Herdado de WebZone) |
| RenderHeader(HtmlTextWriter) |
Substitui o método base para renderizar o cabeçalho de uma zona WebPartZoneBase que contém controles WebPart. (Herdado de WebPartZoneBase) |
| 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) |
| RestoreWebPart(WebPart) |
Restaura um controle WebPart selecionado que foi minimizada para o estado normal. (Herdado de WebPartZoneBase) |
| 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 WebPartZoneBase) |
| 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() |
Inicia o processo de acompanhamento de alterações de estado de exibição para uma zona para que ela possa ser armazenada em um objeto StateBag e acessada por meio da propriedade ViewState. (Herdado de WebPartZoneBase) |
Eventos
| CreateVerbs |
Ocorre quando os verbos são criados para uma zona derivada da classe WebPartZoneBase. (Herdado de WebPartZoneBase) |
| 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) |
Para obter uma descrição desse membro, confira RaisePostBackEvent(String). (Herdado de WebPartZoneBase) |
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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de