GenericWebPart Classe

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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.

Encapsula controles de servidor que não WebPart são controles para que possam aparecer e se comportar como controles verdadeiros 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: Object

Control

WebControl

Panel

Part

WebPart
GenericWebPart

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 automaticamente encapsulados 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, ao controle, 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 funcionalidade de Web Parts, para que qualquer ASP.NET, personalizado ou controle de usuário possa participar de aplicativos web parts.	Existe para criar controles de ASP.NET personalizados que têm funcionalidade de Web Parts nativa 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 mais simples para os desenvolvedores usar controles de servidor e controles de usuário em aplicativos de 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 e controles de servidor existentes em aplicativos de 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 seu servidor ou controle de usuário a uma WebPartZoneBase zona, programaticamente ou declarando-a na marcação da página, e o conjunto de controle de Web Parts encapsula automaticamente seu controle com um GenericWebPart objeto em tempo de execução.

Como os controles de servidor que são 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 WebControlusuário e controles personalizados que herdam) 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. Neste caso, você tem duas opções. Você pode usar o controle personalizado sem as IWebPart propriedades ou 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 herda 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 outras. 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 que você acesse 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 . Como observado, você pode usar essas propriedades com qualquer controle filho, para que ela 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, TitleUrl Titlee Width, podem ser definidas na marcação declarativa para qualquer controle de servidor que seja 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 todas as renderizações aos controles filho encapsulados. Os construtores da GenericWebPart classe são protegidos e são destinados a uso interno ou para 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 e IWebPart IWebActionable interfaces 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á poucas 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 é criado. Por exemplo, talvez você queira armazenar o controle filho em algum lugar diferente da coleção de controle dentro da GenericWebPart classe. Se você herdar da GenericWebPart classe, também precisará herdar da classe e substituir seu WebPartManager CreateWebPart(Control) método para habilitá-la a criar seu controle personalizado.

Construtores

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

Propriedades

Nome	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
AllowClose	Obtém ou define um valor que indica se um usuário final pode fechar um WebPart controle em uma página da Web. (Herdado de WebPart)
AllowConnect	Obtém ou define um valor que indica se o WebPart controle 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 WebPart controle por meio da interface do usuário (interface do usuário) fornecida por um ou mais EditorPart controles. (Herdado de WebPart)
AllowHide	Obtém ou define um valor que indica se os usuários finais têm permissão para ocultar um WebPart controle. (Herdado de WebPart)
AllowMinimize	Obtém ou define um valor que indica se os usuários finais podem minimizar um WebPart controle. (Herdado de WebPart)
AllowZoneChange	Obtém ou define um valor que indica se um usuário pode mover um WebPart controle entre WebPartZoneBase zonas. (Herdado de WebPart)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl)
AuthorizationFilter	Obtém ou define uma cadeia de caracteres arbitrária para determinar se um WebPart controle está autorizado a 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 plano de fundo para o controle do painel. (Herdado de Panel)
BindingContainer	Obtém o controle que contém a associaçã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 do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl)
CatalogIconImageUrl	Obtém ou define a URL para uma imagem que representa um GenericWebPart controle em um catálogo de controles.
ChildControl	Obtém uma referência ao controle filho que é encapsulado por um GenericWebPart controle em tempo de execução.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
ChromeState	Obtém ou define se um controle de parte está em um estado minimizado ou normal. (Herdado de WebPart)
ChromeType	Obtém ou define o tipo de borda que enquadra um controle de Web Parts. (Herdado de WebPart)
ClientID	Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control)
ConnectErrorMessage	Obtém uma mensagem de erro a ser exibida aos usuários se ocorrerem erros durante o processo de conexão. (Herdado de WebPart)
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que contém os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de Part)
ControlStyle	Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. 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 implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control)
DefaultButton	Obtém ou define o identificador do botão padrão contido no Panel controle. (Herdado de Panel)
Description	Obtém ou define uma breve frase que resume o que um controle faz, para uso em Dicas de Ferramentas 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 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 exibido na barra de título de uma WebPart instância de controle. (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 do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de representantes do 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 WebPart controle 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 do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl)
GroupingText	Obtém ou define a legenda do grupo de controles contido 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 do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control)
HasSharedData	Obtém um valor que indica se um WebPart controle tem dados de personalização compartilhados associados a ele. (Herdado de WebPart)
HasUserData	Obtém um valor que indica se um WebPart controle 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 usada para exibir o conteúdo da Ajuda para um WebPart controle. (Herdado de WebPart)
HelpUrl	Obtém ou define a URL como um arquivo de Ajuda para um WebPart controle. (Herdado de WebPart)
Hidden	Obtém ou define um valor que indica se um WebPart controle é exibido em uma página da Web. (Herdado de WebPart)
HorizontalAlign	Obtém ou define o alinhamento horizontal do conteúdo dentro do 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 usada se ocorrerem erros quando um WebPart controle é importado. (Herdado de WebPart)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsClosed	Obtém um valor que indica se um WebPart controle está fechado atualmente 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 WebPart controle é 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 WebPart controle é autônomo, o que significa que ele não está contido em uma WebPartZoneBase zona. (Herdado de WebPart)
IsStatic	Obtém um valor que indica se um WebPart controle é 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 do servidor está salvando alterações em seu 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 no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão 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 Panel controle. (Herdado de Panel)
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a pele 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 do servidor Web. (Herdado de WebControl)
Subtitle	Obtém uma cadeia de caracteres concatenada com o valor da Title propriedade para formar um título completo para um controle.
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é `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 HtmlTextWriterTag valor que corresponde a esse controle de 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 esse controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control)
Title	Obtém ou define o título de um GenericWebPart controle.
TitleIconImageUrl	Obtém ou define a URL para uma imagem usada para representar um GenericWebPart controle na própria barra de título do controle.
TitleUrl	Obtém ou define uma URL para obter informações complementares sobre um GenericWebPart controle.
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control)
Verbs	Obtém uma coleção de verbos personalizados associados a um GenericWebPart controle.
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 StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control)
WebBrowsableObject	Obtém uma referência ao controle filho para permitir que o controle seja editado por controles personalizados EditorPart .
WebPartManager	Obtém uma referência ao WebPartManager controle associado a uma WebPart instância de controle. (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 encapsula dentro do painel. (Herdado de Panel)
Zone	Obtém a WebPartZoneBase zona que atualmente contém um WebPart controle. (Herdado de WebPart)
ZoneIndex	Obtém a posição de índice de um WebPart controle dentro de sua zona. (Herdado de WebPart)

Métodos

Nome	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona informações sobre a imagem de plano de fundo, alinhamento, encapsulamento e direção à lista de atributos a serem renderizados. (Herdado de Panel)
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control)
ApplyStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do 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 do servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateChildControls()	Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização.
CreateControlCollection()	Substitui o método base para criar uma coleção somente leitura que consiste no controle filho encapsulado por um GenericWebPart controle.
CreateControlStyle()	Cria um objeto de estilo que é usado internamente pelo Panel controle 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 GenericWebPart controle quando ele está no modo de edição.
DataBind()	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho. (Herdado de Part)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (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 de ser liberado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, 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, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada como um controle. (Herdado de Control)
GetDesignModeState()	Obtém 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 UniqueID propriedade do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle do servidor contém controles filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle do servidor contém apenas 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 SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o SaveViewState() método. (Herdado de WebControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MergeStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control)
OnClosing(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle é fechado em uma página de Web Parts. (Herdado de WebPart)
OnConnectModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle está iniciando ou encerrando 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 WebPart controle é permanentemente removido de uma página de Web Parts. (Herdado de WebPart)
OnEditModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controle 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 todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Delegados renderizando o conteúdo do controle para o controle filho.
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do Panel controle para o gravador especificado. (Herdado de Panel)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do Panel controle no 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 é utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control)
SaveViewState()	Salva qualquer estado modificado após a invocação do TrackViewState() método. (Herdado de WebControl)
SetDesignModeState(IDictionary)	Define 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 atual WebPart . (Herdado de WebPart)
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos 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 rastreie as alterações no estado de exibição para que elas possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebPart)

Eventos

Nome	Description
DataBinding	Ocorre quando o controle do 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 do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

Nome	Description
IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite que o desenvolvedor de um designer para um controle de parte composta recrie os controles filho do controle na superfície de design. (Herdado de Part)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

Nome	Description
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.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a coleção dos valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

GenericWebPart Classe

Definição

Exemplos

Comentários

Notas aos Herdeiros

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

Comentários