Compartilhar via


GenericWebPart Classe

Definição

Encapsula controles de servidor que não sejam controles WebPart para que eles possam parecer e se comportar como controles verdadeiramente WebPart em tempo de execução.

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

Exemplos

O exemplo de código a seguir demonstra como o GenericWebPart controle encapsula automaticamente um controle de servidor que não é um WebPart controle em tempo de execução.

A primeira parte do exemplo de código contém uma página de Web Parts com dois WebPartZone controles. Dentro de cada zona há um controle de servidor ASP.NET padrão. Como os controles estão em uma WebPartZone zona, eles serão encapsulados automaticamente com um GenericWebPart controle quando a página for compilada. Portanto, você pode declarar WebPart propriedades de classe nesses controles. Depois de carregar a página em um navegador, se você clicar no botão Exibir Todos os Valores de Propriedade , os detalhes de cada controle serão exibidos em um rótulo. Para mostrar como o GenericWebPart controle funciona, o Calendar controle na primeira zona tem algumas das GenericWebPart propriedades definidas na marcação declarativa da página .aspx, enquanto o BulletedList controle não. Depois de carregar a página, observe as diferenças nos valores de propriedade dos dois controles e que ambos têm um controle pai GenericWebPart .

<%@ Page Language="C#" 
  Codefile="genericwebpart.cs" 
  Inherits="genericwebpart_sample" %>
<!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>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <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>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>
<%@ Page Language="vb" 
  Codefile="genericwebpart.vb" 
  Inherits="genericwebpart_sample" %>
<!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 id="Head1" runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <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>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>

A segunda parte do exemplo de código mostra uma classe parcial que acessa algumas propriedades do GenericWebPart controle programaticamente. Observe que, no Page_Load método , o GetGenericWebPart método é usado para recuperar a instância de tempo de execução do GenericWebPart controle que encapsula um controle de servidor. Essa abordagem de obter uma referência ao controle pai GenericWebPart permite que você trabalhe programaticamente com um servidor ou controle de usuário comum como se fosse um WebPart controle em tempo de execução.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class genericwebpart_sample : System.Web.UI.Page
{
  GenericWebPart calendarPart;
  GenericWebPart listPart;

  protected void Page_Load(Object sender, EventArgs e)
  {
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1);
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1);

    if (!IsPostBack)
    {
      Label2.Text = String.Empty;
      Label3.Text = String.Empty;
    }
  }

  protected void Button1_Click(object sender, EventArgs e)
  {

    Label2.Text =
      @"<h3>Calendar GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + calendarPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + calendarPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + calendarPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

    Label3.Text =
      @"<h3>BulletedList GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + listPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + listPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + listPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + listPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
  }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Partial Public Class genericwebpart_sample

  Inherits System.Web.UI.Page

  Private calendarPart As GenericWebPart
  Private listPart As GenericWebPart

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1)
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1)

    If Not IsPostBack Then
      Label2.Text = String.Empty
      Label3.Text = String.Empty
    End If

  End Sub


  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

Comentários

O GenericWebPart controle existe para fornecer um wrapper em tempo de execução para controles de servidor que não WebPart são controles, para que esses controles possam ser usados em páginas e aplicativos de Web Parts. Quando os desenvolvedores adicionam controles de servidor, como controles de usuário, controles de servidor ASP.NET ou controles personalizados existentes, o GenericWebPart controle encapsula automaticamente os controles do servidor em tempo de execução para WebPartZoneBase que eles possam exibir a mesma funcionalidade que os controles verdadeirosWebPart.

A tabela a seguir compara e contrasta controles e WebPart controlesGenericWebPart.

Controle GenericWebPart Controle WebPart
Existe para equipar controles de servidor que não WebPart são controles com a funcionalidade de Web Parts, para que qualquer controle de ASP.NET, personalizado ou de usuário possa participar de aplicativos de Web Parts. Existe para criar controles de ASP.NET personalizados que têm funcionalidade nativa de Web Parts interna. Isso inclui personalização, conexões, importação e exportação e recursos de arrastar e soltar.
Nunca é declarado na marcação de uma página. Ele existe apenas para encapsular controles de servidor em tempo de execução e dar ao controle encapsulado (ou controle filho) a funcionalidade completa de um WebPart controle. Pode ser declarado na marcação de uma página em tempo de design, como um controle de servidor ASP.NET, exceto que ele é declarado em uma WebPartZoneBase zona.
Inclui e integra seu controle filho ao processo de personalização de Web Parts para que ele possa atuar como um controle verdadeiro WebPart . Isso ocorre automaticamente, o que torna simples para os desenvolvedores usar controles de servidor e controles de usuário em aplicativos web parts. É incluído automaticamente no processo de personalização de Web Parts.
Pode ser acessado programaticamente em tempo de execução (usando o GetGenericWebPart método e passando para ele o controle do servidor filho), como um controle verdadeiro WebPart ou um controle de ASP.NET padrão. Pode ser acessado programaticamente em tempo de execução, como um controle de ASP.NET padrão.

Os usuários se beneficiam do GenericWebPart controle porque ele fornece uma experiência de usuário consistente. Qualquer controle de servidor pode ser feito para funcionar como um WebPart controle e terá os mesmos elementos de interface do usuário consistentes, como verbos, ícones, um título e um cabeçalho. Os desenvolvedores se beneficiam do GenericWebPart controle porque ele permite que eles reutilizem controles de usuário existentes e controles de servidor em aplicativos web parts.

Observação

Ao criar páginas de Web Parts, você não precisa fazer nada para permitir que um controle de usuário existente ou controle personalizado seja encapsulado com o GenericWebPart controle . Basta adicionar o servidor ou o controle de usuário a uma WebPartZoneBase zona, programaticamente ou declarando-o na marcação da página, e o conjunto de controle de Web Parts encapsula automaticamente o controle com um GenericWebPart objeto em tempo de execução.

Como os controles de servidor colocados em WebPartZoneBase zonas são encapsulados com um GenericWebPart controle em tempo de execução, os desenvolvedores podem usar controles comuns de servidor e usuário exatamente como se fossem WebPart controles. Observe que, se você declarar controles personalizados que herdam da classe base Control dentro de um WebPartZone, esses controles não poderão dar suporte ao uso das propriedades intrínsecas WebPart . Portanto, você não pode declarar as IWebPart propriedades nesses controles, incluindo propriedades como a Title propriedade e a Description propriedade . Por outro lado, outros tipos de controles de servidor (como WebPart controles, controles de usuário e controles personalizados herdados de WebControl) podem declarar essas propriedades, pois dão suporte ao uso de propriedades expando.

As propriedades expando são, na verdade, cadeias de caracteres que podem ser adicionadas a uma classe dinamicamente como uma propriedade, por meio da IAttributeAccessor interface . Os controles que implementam essa interface, incluindo a WebControl classe e seus filhos, podem usar propriedades expando. Como a classe base Control não dá suporte a propriedades expando, quando um controle personalizado herdado da Control classe é colocado em um WebPartZone e encapsulado com um GenericWebPart controle em tempo de execução, o conjunto de controle de Web Parts não pode adicionar dinamicamente as propriedades intrínsecas IWebPart ao controle personalizado. Você tem duas opções neste caso. Você pode usar o controle personalizado sem as IWebPart propriedades ou pode implementar a IWebPart interface no controle personalizado, permitindo que ela use as propriedades.

Como exemplo de como os controles herdados WebControl podem usar as IWebPart propriedades, se você declarar um controle ASP.NET Calendar na marcação de uma página (dentro de uma WebPartZoneBase zona) em tempo de design, mesmo que esse controle não herde da WebPart classe e não contenha WebPart membros nativamente, você ainda poderá tratá-lo exatamente como um WebPart controle. Você pode declarar WebPart propriedades no controle de calendário, como Title, Descriptione outros. Em tempo de execução, você pode usar o GetGenericWebPart método , que retorna o GenericWebPart controle que está encapsulando dinamicamente o controle de calendário e trabalhar com ele programaticamente exatamente como faria com um WebPart controle, com acesso a todas as mesmas propriedades, eventos e métodos.

O GenericWebPart controle tem uma propriedade crítica que permite acessar seu controle de servidor subjacente: a ChildControl propriedade . Essa propriedade permite que os desenvolvedores acessem programaticamente o controle do servidor. A ChildControl propriedade também é usada pelo WebPartManager controle para acessar dados de personalização do controle filho e para executar a autorização, se a AuthorizationFilter propriedade estiver definida.

O GenericWebPart controle tem várias outras propriedades, todas as quais substituem as propriedades herdadas da classe base WebPart . Conforme observado, você pode usar essas propriedades com qualquer controle filho, para que ele possa se comportar como um WebPart controle. Uma propriedade importante é a ExportMode propriedade ; ela determina se todas as propriedades exportáveis ou somente aquelas marcadas como não sensíveis podem ser exportadas. As propriedades orientadas à interface do usuário herdadas da WebPart classe , como CatalogIconImageUrl, Description, Height, Title, TitleUrle Width, podem ser definidas na marcação declarativa para qualquer controle de servidor colocado em uma WebPartZoneBase zona.

Os métodos importantes na GenericWebPart classe incluem o CreateControlCollection método , que cria a coleção de controles (incluindo controles filho) associados a um GenericWebPart controle e o Render método , que delega toda a renderização para os controles filho encapsulados. Os construtores na GenericWebPart classe são protegidos e destinam-se ao uso interno ou a cenários de extensibilidade.

Há alguns insights úteis adicionais para trabalhar com GenericWebPart controles. Se você quiser definir valores padrão para as propriedades substituídas na classe , seu GenericWebPart controle de usuário ou controle de servidor personalizado poderá implementar as IWebPart interfaces e IWebActionable e substituir seus membros. Em tempo de execução, o GenericWebPart controle obterá seus valores para as propriedades implementadas do controle filho que implementa as interfaces. Se o controle definir qualquer uma de suas propriedades como personalizável (usando o Personalizable atributo de metadados), o GenericWebPart controle habilitará automaticamente essas propriedades para personalização em tempo de execução, assim como as propriedades personalizáveis em um WebPart controle.

Se você quiser fornecer recursos de edição de Web Parts para seu controle, poderá implementar a IWebEditable interface . Em tempo de execução, quando o CreateEditorParts método é chamado, o GenericWebPart código do controle para a WebBrowsableObject propriedade chamará para a mesma propriedade no controle filho e usará a implementação do controle filho para criar controles personalizados EditorPart associados.

Notas aos Herdeiros

Há algumas ocasiões em que é necessário herdar da GenericWebPart classe . Um desses casos seria se um desenvolvedor quisesse implementar alguma ação personalizada no construtor quando um GenericWebPart controle for criado. Por exemplo, talvez você queira armazenar o controle filho em outro lugar que não seja a coleção de controle dentro da GenericWebPart classe . Se você herdar da GenericWebPart classe , também precisará herdar da classe e substituir seu WebPartManagerCreateWebPart(Control) método para habilitá-la para criar seu controle personalizado.

Construtores

GenericWebPart(Control)

Inicializa uma nova instância de um controle GenericWebPart passando uma referência a um controle que se torna o controle filho.

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

Obtém ou define um valor que indica se um usuário final pode fechar um controle WebPart em uma página da Web.

(Herdado de WebPart)
AllowConnect

Obtém ou define um valor que indica se o controle WebPart permite que outros controles formem conexões com ele.

(Herdado de WebPart)
AllowEdit

Obtém ou define um valor que indica se um usuário final pode modificar um controle WebPart por meio da interface do usuário fornecida por um ou mais controles EditorPart.

(Herdado de WebPart)
AllowHide

Obtém ou define um valor que indica se os usuários finais podem ocultar um controle WebPart.

(Herdado de WebPart)
AllowMinimize

Obtém ou define um valor que indica se os usuários finais podem minimizar um controle WebPart.

(Herdado de WebPart)
AllowZoneChange

Obtém ou define um valor que indica se um usuário pode mover um controle WebPart entre zonas WebPartZoneBase.

(Herdado de WebPart)
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)
AuthorizationFilter

Obtém ou define uma cadeia de caracteres arbitrária para determinar se um controle WebPart tem autorização para ser adicionado a uma página.

(Herdado de WebPart)
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 da imagem de tela de fundo do controle do painel.

(Herdado de Panel)
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)
CatalogIconImageUrl

Obtém ou define a URL para uma imagem que representa um controle GenericWebPart em um catálogo de controles.

ChildControl

Obtém uma referência para o controle filho que é encapsulado por um controle GenericWebPart em tempo de execução.

ChildControlsCreated

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

(Herdado de Control)
ChromeState

Obtém ou define se um controle Part está em um estado minimizado ou normal.

(Herdado de WebPart)
ChromeType

Obtém ou define o tipo de borda que emoldura um controle de Web Parts.

(Herdado de WebPart)
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)
ConnectErrorMessage

Obtém uma mensagem de erro para exibir para os usuários se ocorrerem erros durante o processo de conexão.

(Herdado de WebPart)
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 contém os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.

(Herdado de Part)
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)
DefaultButton

Obtém ou define o identificador do botão padrão contido no controle Panel.

(Herdado de Panel)
Description

Obtém ou define uma frase curta que resume o que um controle faz, para ser usada em dicas de ferramenta e catálogos de controles de servidor.

DesignMode

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

(Herdado de Control)
Direction

Obtém ou define a direção horizontal em que o conteúdo flui dentro do controle.

(Herdado de WebPart)
DisplayTitle

Obtém uma cadeia de caracteres que contém o texto de título completo realmente exibido na barra de título de uma instância de controle WebPart.

(Herdado de WebPart)
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)
Events

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

(Herdado de Control)
ExportMode

Obtém ou define se todas, algumas ou nenhuma das propriedades de um controle WebPart podem ser exportadas.

(Herdado de WebPart)
Font

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

(Herdado de WebControl)
ForeColor

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

(Herdado de WebControl)
GroupingText

Obtém ou define a legenda para o grupo de controles contidos no controle do painel.

(Herdado de Panel)
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)
HasSharedData

Obtém um valor que indica se um controle WebPart tem dados de personalização compartilhados associados a ele.

(Herdado de WebPart)
HasUserData

Obtém um valor que indica se um controle WebPart tem dados de personalização de usuário associados a ele.

(Herdado de WebPart)
Height

Obtém ou define a altura (em pixels) de um controle.

HelpMode

Obtém ou define o tipo de interface do usuário a ser usada para exibir o conteúdo de Ajuda para um controle WebPart.

(Herdado de WebPart)
HelpUrl

Obtém ou define a URL para um arquivo de Ajuda para um controle WebPart.

(Herdado de WebPart)
Hidden

Obtém ou define um valor que indica se um controle WebPart é exibido em uma página da Web.

(Herdado de WebPart)
HorizontalAlign

Obtém ou define o alinhamento horizontal do conteúdo no painel.

(Herdado de Panel)
ID

Obtém ou define a ID de um controle. Esse valor não é herdável.

IdSeparator

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

(Herdado de Control)
ImportErrorMessage

Obtém ou define uma mensagem de erro que é usada se ocorrerem erros quando um controle WebPart for importado.

(Herdado de WebPart)
IsChildControlStateCleared

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

(Herdado de Control)
IsClosed

Obtém um valor que indica se um controle WebPart está fechado no momento em uma página de Web Parts.

(Herdado de WebPart)
IsEnabled

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

(Herdado de WebControl)
IsShared

Obtém um valor que indica se um controle WebPart é compartilhado, o que significa que ele é visível para todos os usuários de uma página de Web Parts.

(Herdado de WebPart)
IsStandalone

Obtém um valor que indica se um controle WebPart é autônomo, o que significa que ele não está contido em uma zona WebPartZoneBase.

(Herdado de WebPart)
IsStatic

Obtém um valor que indica se um controle WebPart é um controle estático, o que significa que o controle é declarado na marcação de uma página de Web Parts e não adicionado à página programaticamente.

(Herdado de WebPart)
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)
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)
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)
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)
ScrollBars

Obtém ou define a visibilidade e a posição das barras de rolagem em um controle Panel.

(Herdado de Panel)
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)
Subtitle

Obtém uma cadeia de caracteres que é concatenada com o valor da propriedade Title para compor um título completo para um controle.

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 Panel)
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 WebControl)
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)
Title

Obtém ou define o título de um controle GenericWebPart.

TitleIconImageUrl

Obtém ou define a URL para uma imagem usada para representar um controle GenericWebPart na barra de título do próprio controle.

TitleUrl

Obtém ou define uma URL para informações complementares sobre um controle GenericWebPart.

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

Obtém uma coleção de verbos personalizados associados a um controle GenericWebPart.

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

Obtém uma referência para o controle filho, a fim de habilitar o controle para ser editado pelos controles personalizados EditorPart.

WebPartManager

Obtém uma referência para o controle WebPartManager associado a uma instância do controle WebPart.

(Herdado de WebPart)
Width

Obtém ou define a largura (em pixels) do controle.

Wrap

Obtém ou define um valor que indica se o conteúdo será quebrado dentro do painel.

(Herdado de Panel)
Zone

Obtém a zona WebPartZoneBase que contém um controle WebPart no momento.

(Herdado de WebPart)
ZoneIndex

Obtém a posição do índice de um controle WebPart dentro da zona.

(Herdado de WebPart)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona informações sobre a imagem de tela de fundo, o alinhamento, o encapsulamento e a direção para a lista de atributos a renderizar.

(Herdado de Panel)
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)
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()

Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização.

CreateControlCollection()

Substitui o método base para criar uma coleção somente leitura que consiste no controle filho encapsulado por um controle GenericWebPart.

CreateControlStyle()

Cria um objeto de estilo que é usado internamente pelo controle Panel para implementar todas as propriedades relacionadas ao estilo.

(Herdado de Panel)
CreateEditorParts()

Retorna uma coleção de controles personalizados EditorPart que podem ser usados para editar o controle filho de um controle GenericWebPart quando ele está em modo de edição.

DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.

(Herdado de Part)
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)
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)
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)

Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o método SaveViewState().

(Herdado de WebControl)
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)
OnClosing(EventArgs)

Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart é fechado em uma página de Web Parts.

(Herdado de WebPart)
OnConnectModeChanged(EventArgs)

Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart está iniciando ou concluindo o processo de conexão com outros controles.

(Herdado de WebPart)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnDeleting(EventArgs)

Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart é removido permanentemente de uma página de Web Parts.

(Herdado de WebPart)
OnEditModeChanged(EventArgs)

Permite que classes derivadas forneçam tratamento personalizado quando um controle WebPart está entrando ou saindo do modo de edição.

(Herdado de WebPart)
OnInit(EventArgs)

Aciona o evento Init.

(Herdado de Control)
OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnPreRender(EventArgs)

Aciona o evento PreRender.

(Herdado de Control)
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)
RemovedControl(Control)

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

(Herdado de Control)
Render(HtmlTextWriter)

Delega a renderização do conteúdo do controle para o controle filho.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle Panel para o gravador especificado.

(Herdado de Panel)
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 o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
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 Panel para o gravador especificado.

(Herdado de Panel)
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 qualquer estado que foi modificado depois que o método TrackViewState() foi invocado.

(Herdado de WebControl)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetPersonalizationDirty()

Define um sinalizador que indica que os dados de personalização foram alterados para a instância de controle WebPart atual.

(Herdado de WebPart)
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()

Faz com que o controle acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto.

(Herdado de WebPart)

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 ao desenvolvedor de um designer para um controle Part de composição recriar os controles filho do controle na superfície de design.

(Herdado de Part)
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)

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