GenericWebPart Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls.WebParts

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Envolve os controlos do servidor que não WebPart são controlos para que possam aparecer e comportar-se como controlos 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 seguinte demonstra como o controlo GenericWebPart envolve automaticamente um controlo de servidor que não é controlo WebPart em tempo de execução.

A primeira parte do exemplo de código contém uma página de Web Parts com dois WebPartZone controlos. Dentro de cada zona existe um controlo padrão de servidor ASP.NET. Como os controlos estão numa WebPartZone zona, serão automaticamente encapsulados com um GenericWebPart controlo quando a página for compilada. Portanto, pode declarar WebPart propriedades de classe nestes controlos. Depois de carregar a página num navegador, se clicar no botão Mostrar Todos os Valores de Propriedade , os detalhes de cada controlo são exibidos numa etiqueta. Para mostrar como funciona o GenericWebPart controlo, o Calendar controlo na primeira zona tem algumas das GenericWebPart propriedades definidas na marcação declarativa da página .aspx, enquanto o BulletedList controlo não. Depois de carregares a página, nota as diferenças nos valores das propriedades dos dois controlos, e que ambos têm um controlo 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 acede algumas propriedades do GenericWebPart controlo programaticamente. Note que, no Page_Load método, o GetGenericWebPart método é usado para recuperar a instância em tempo de execução do GenericWebPart controlo que envolve um controlo de servidor. Esta abordagem de obter uma referência ao controlo pai GenericWebPart permite-lhe trabalhar programaticamente com um servidor comum ou controlo de utilizador como se fosse um WebPart controlo 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

Observações

O GenericWebPart controlo existe para fornecer um wrapper em tempo de execução para controlos de servidor que não WebPart são controlos, de modo a que tais controlos possam ser usados em páginas e aplicações de Web Parts. Quando os programadores adicionam controlos de servidor — como controlos de utilizador, controlos de ASP.NET servidor ou controlos personalizados existentes — a um controlo WebPartZoneBase, o controlo GenericWebPart envolve automaticamente os controlos do servidor em tempo de execução para que possam exibir a mesma funcionalidade que os verdadeiros controlos WebPart.

A tabela seguinte compara e contrasta GenericWebPart os controlos e WebPart os controlos.

GenericWebPart controlo	WebPart controlo
Existe para equipar os controlos de servidor que não são controlos WebPart com funcionalidade de Web Parts, para que qualquer controlo ASP.NET, personalizado ou de utilizador possa participar em aplicações Web Parts.	Existe para criar controlos ASP.NET personalizados que tenham funcionalidade nativa de Web Parts incorporada. Isto inclui personalização, ligações, importação e exportação, e capacidades de arrastar e largar.
Nunca é declarado na marcação de uma página. Existe apenas para encapsular os controlos do servidor em tempo de execução e para dar ao controlo encapsulado (ou controlo filho) a funcionalidade total de um WebPart controlo.	Pode ser declarado na marcação de uma página no momento do design, como um controlo de servidor ASP.NET, exceto que é declarado numa zona WebPartZoneBase.
Inclui e integra o seu controlo filho no processo de personalização do Web Parts, para que possa atuar como um verdadeiro WebPart controlo. Isto ocorre automaticamente, o que facilita aos programadores a utilização de controlos de servidor e de utilizador em aplicações Web Parts.	É automaticamente incluído no processo de personalização de Web Parts.
Pode ser acedido programaticamente em tempo de execução (usando o método GetGenericWebPart e passando-lhe o controlo do servidor filho), como um verdadeiro controlo WebPart ou um controlo ASP.NET padrão.	Pode ser acedido programaticamente em tempo de execução, como um controlo ASP.NET padrão.

Os utilizadores beneficiam do GenericWebPart controlo porque proporciona uma experiência consistente. Qualquer controlo de servidor pode funcionar como um WebPart controlo, e terá os mesmos elementos consistentes de interface de utilizador (UI), como verbos, ícones, um título e um cabeçalho. Os programadores beneficiam do GenericWebPart controlo porque lhes permite reutilizar controlos existentes de utilizador e de servidor dentro de aplicações Web Parts.

Note

Quando cria páginas de Web Parts, não precisa de fazer nada para permitir que um controlo de utilizador existente ou um controlo personalizado seja envolvido com o GenericWebPart controlo. Basta adicionar o controlo do seu servidor ou utilizador a uma WebPartZoneBase zona, seja programaticamente ou declarando-o na marcação da página, e o conjunto de controlo Web Parts envolve automaticamente o seu controlo com um GenericWebPart objeto em tempo de execução.

Como os controlos de servidor colocados em WebPartZoneBase zonas são envolvidos com um GenericWebPart controlo em tempo de execução, os programadores podem usar controlos normais de servidor e utilizador exatamente como se fossem WebPart controlos. Note que, se declarar controlos personalizados que herdam da classe base Control dentro de um WebPartZone, esses controlos não podem suportar o uso das propriedades intrínsecas WebPart . Assim, não pode declarar as IWebPart propriedades nesses controlos, incluindo propriedades como a Title propriedade e a propriedade Description . Em contraste, outros tipos de controlos de servidor (como WebPart controlos, controlos de utilizador e controlos personalizados que herdam de WebControl) podem declarar estas propriedades, porque suportam o uso de propriedades expando.

As propriedades expando são, na verdade, cadeias que podem ser adicionadas a uma classe dinamicamente como uma propriedade, através da IAttributeAccessor interface. Os controlos que implementam esta interface, incluindo a WebControl classe e os seus filhos, podem usar propriedades expando. Como a classe base Control não suporta propriedades expando, quando um controlo personalizado que herda da Control classe é colocado em a WebPartZone e envolvido com um GenericWebPart controlo em tempo de execução, o conjunto de controlos Web Parts não pode adicionar dinamicamente as propriedades intrínsecas IWebPart ao controlo personalizado. Tens duas opções neste caso. Podes usar o controlo personalizado sem as IWebPart propriedades, ou podes implementar a IWebPart interface no controlo personalizado, permitindo que ele use as propriedades.

Como exemplo de como controlos que herdam de WebControl podem usar as propriedades IWebPart, se declarar um controlo ASP.NET Calendar na marcação de uma página (dentro de uma zona WebPartZoneBase) em tempo de design, mesmo que este controlo não herde da classe WebPart e não contenha nativamente membros WebPart, Ainda podes tratá-lo exatamente como um controlo . Pode declarar WebPart propriedades no controlo do calendário, como Title, Description, e outras. Em tempo de execução, podes usar o GetGenericWebPart método, que devolve o GenericWebPart controlo que está a envolver dinamicamente o controlo do calendário, e trabalhar com ele programaticamente exatamente como farias com um WebPart controlo, com acesso a todas as mesmas propriedades, eventos e métodos.

O GenericWebPart controlo tem uma propriedade crítica que permite aceder ao seu controlo de servidor subjacente: a ChildControl propriedade. Esta propriedade permite aos programadores aceder programaticamente ao controlo do servidor. A ChildControl propriedade é também usada pelo WebPartManager controlo para aceder a dados de personalização do controlo filho e para realizar autorização, caso a AuthorizationFilter propriedade esteja definida.

O GenericWebPart controlo tem várias outras propriedades, todas as quais sobrepõem propriedades herdadas da classe base WebPart . Como referido, pode usar estas propriedades com qualquer controlo filho, para que possa comportar-se como controlo WebPart . Uma propriedade importante é a ExportMode propriedade; determina se todas as propriedades exportáveis, ou apenas aquelas marcadas como não sensíveis, podem ser exportadas. As propriedades orientadas à interface de utilizador herdadas da WebPart classe, como CatalogIconImageUrl, Description, Height, Title, TitleUrl, e Width, podem ser definidas na marcação declarativa para qualquer controlo de servidor que seja colocado numa WebPartZoneBase zona.

Métodos importantes na GenericWebPart classe incluem o CreateControlCollection método, que cria a coleção de controlos (incluindo controlos filhos) associados a um GenericWebPart controlo, e o Render método, que delega toda a renderização aos controlos filhos encapsulados. Os construtores da GenericWebPart classe estão protegidos e destinam-se quer a uso interno, quer a cenários de extensibilidade.

Existem algumas ideias adicionais úteis para trabalhar com GenericWebPart controlos. Se quiseres definir valores por defeito para as propriedades sobrepostas na GenericWebPart classe, o teu controlo de utilizador ou controlo personalizado do servidor pode implementar as IWebPart interfaces and IWebActionable e sobrescrever os seus membros. Em tempo de execução, o controlo GenericWebPart obtém os seus valores para as propriedades implementadas do controlo filho que implementa as interfaces. Se o seu controlo definir alguma das suas propriedades como personalizável (usando o Personalizable atributo de metadados), o controlo GenericWebPart ativa automaticamente essas propriedades para personalização em tempo de execução, tal como as propriedades personalizáveis num WebPart controlo.

Se quiser fornecer funcionalidades de edição de Web Parts para o seu controlo, pode implementar a IWebEditable interface. Em tempo de execução, quando o CreateEditorParts método é chamado, o GenericWebPart código do controlo para a WebBrowsableObject propriedade é chamado para a mesma propriedade no controlo filho e usa a implementação do controlo filho para criar controlos personalizados EditorPart associados.

Notas para Herdeiros

Há poucas ocasiões em que é necessário herdar da GenericWebPart classe. Um desses casos seria se um programador quiser implementar alguma ação personalizada no construtor quando um GenericWebPart controlo é criado. Por exemplo, pode querer armazenar o controlo filho noutro sítio que não a coleção de controlos dentro da GenericWebPart classe. Se herdares da GenericWebPart classe, também precisas de herdar da WebPartManager classe e sobrescrever o método CreateWebPart(Control) para permitir que crie o teu controlo personalizado.

Construtores

Name	Description
GenericWebPart(Control)	Inicializa uma nova instância de um GenericWebPart controlo ao passar uma referência a um controlo que se torna o controlo filho.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl)
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
AllowClose	Obtém ou define um valor que indica se um utilizador final pode fechar um WebPart controlo numa página Web. (Herdado de WebPart)
AllowConnect	Recebe ou define um valor que indica se o controlo WebPart permite que outros controlos formem ligações com ele. (Herdado de WebPart)
AllowEdit	Recebe ou define um valor que indica se um utilizador final pode modificar um WebPart controlo através da interface de utilizador (UI) fornecida por um ou mais EditorPart controlos. (Herdado de WebPart)
AllowHide	Recebe ou define um valor que indica se os utilizadores finais podem ocultar um WebPart controlo. (Herdado de WebPart)
AllowMinimize	Recebe ou define um valor que indica se os utilizadores finais podem minimizar um WebPart controlo. (Herdado de WebPart)
AllowZoneChange	Recebe ou define um valor que indica se um utilizador pode mover um WebPart controlo entre WebPartZoneBase zonas. (Herdado de WebPart)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl)
AuthorizationFilter	Obtém ou define uma cadeia arbitrária para determinar se um WebPart controlo está autorizado a ser adicionado a uma página. (Herdado de WebPart)
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl)
BackImageUrl	Obtém ou define a URL da imagem de fundo do controlo do painel. (Herdado de Panel)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl)
CatalogIconImageUrl	Obtém ou define a URL para uma imagem que representa um GenericWebPart controlo num catálogo de controlos.
ChildControl	Recebe uma referência ao controlo filho que é envolvida por um GenericWebPart controlo em tempo de execução.
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ChromeState	Obtém ou define se um controlo de peça está num estado minimizado ou normal. (Herdado de WebPart)
ChromeType	Obtém ou define o tipo de borda que enquadra um controlo de Web Parts. (Herdado de WebPart)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
ConnectErrorMessage	Recebe uma mensagem de erro para mostrar aos utilizadores se ocorrerem erros durante o processo de ligação. (Herdado de WebPart)
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que contém os controlos filhos de um servidor especificado na hierarquia da interface do utilizador. (Herdado de Part)
ControlStyle	Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
ControlStyleCreated	Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
CssClass	Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DefaultButton	Obtém ou define o identificador do botão padrão que está contido no Panel controlo. (Herdado de Panel)
Description	Recebe ou define uma frase breve que resume o que um controlo faz, para uso em ToolTips e catálogos de controlos de servidor.
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
Direction	Obtém ou define a direção horizontal em que o conteúdo flui dentro do controlo. (Herdado de WebPart)
DisplayTitle	Recebe uma string que contém o texto completo do título realmente apresentado na barra de título de uma WebPart instância de controlo. (Herdado de WebPart)
Enabled	Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl)
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
ExportMode	Obtém ou define se todas, algumas ou nenhuma das propriedades de um WebPart controlo podem ser exportadas. (Herdado de WebPart)
Font	Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl)
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl)
GroupingText	Recebe ou define a legenda para o grupo de controlos que está contido no controlo do painel. (Herdado de Panel)
HasAttributes	Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
HasSharedData	Obtém um valor que indica se um WebPart controlo tem algum dado de personalização partilhado associado. (Herdado de WebPart)
HasUserData	Recebe um valor que indica se um WebPart controlo tem algum dado de personalização do utilizador associado. (Herdado de WebPart)
Height	Obtém ou define a altura (em píxeis) de um controlo.
HelpMode	Obtém ou define o tipo de interface de utilizador (UI) usado para exibir conteúdo de Ajuda para um WebPart controlo. (Herdado de WebPart)
HelpUrl	Obtém ou define a URL para um ficheiro de Ajuda para um WebPart controlo. (Herdado de WebPart)
Hidden	Recebe ou define um valor que indica se um WebPart controlo é exibido numa página 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 o ID de um controlo. Este valor não é hereditário.
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
ImportErrorMessage	Recebe ou define uma mensagem de erro que é usada se ocorrerem erros quando um WebPart controlo é importado. (Herdado de WebPart)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsClosed	Recebe um valor que indica se um WebPart controlo está atualmente fechado numa página de Web Parts. (Herdado de WebPart)
IsEnabled	Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl)
IsShared	Recebe um valor que indica se um WebPart controlo é partilhado, o que significa que é visível para todos os utilizadores de uma página de Web Parts. (Herdado de WebPart)
IsStandalone	Obtém um valor que indica se um WebPart controlo é autónomo, ou seja, que não está contido numa WebPartZoneBase zona. (Herdado de WebPart)
IsStatic	Recebe um valor que indica se um WebPart controlo é estático, o que significa que o controlo é declarado na marcação de uma página de Web Parts e não é adicionado programaticamente à página. (Herdado de WebPart)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
RenderingCompatibility	Recebe 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 scroll num Panel controlo. (Herdado de Panel)
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl)
Style	Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl)
Subtitle	Obtém uma cadeia que é concatenada com o Title valor da propriedade para formar um título completo para um controlo.
SupportsDisabledAttribute	Obtém um valor que indica se o controlo deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é `false`. (Herdado de Panel)
TabIndex	Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TagName	Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
Title	Recebe ou define o título de um GenericWebPart controlo.
TitleIconImageUrl	Obtém ou define a URL para uma imagem usada para representar um GenericWebPart controlo na barra de título do controlo.
TitleUrl	Obtém ou define uma URL para informação suplementar sobre um GenericWebPart controlo.
ToolTip	Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
Verbs	Recebe uma coleção de verbos personalizados associados a um GenericWebPart controlo.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control)
WebBrowsableObject	Recebe uma referência ao controlo filho, para permitir que o controlo seja editado por controlos personalizados EditorPart .
WebPartManager	Obtém uma referência ao WebPartManager controlo associado a uma WebPart instância de controlo. (Herdado de WebPart)
Width	Obtém ou define a largura (em pixels) do controlo.
Wrap	Recebe ou define um valor que indica se o conteúdo se envolve dentro do painel. (Herdado de Panel)
Zone	Obtém a WebPartZoneBase zona que atualmente contém um WebPart controlo. (Herdado de WebPart)
ZoneIndex	Obtém a posição índice de um WebPart controlo dentro da sua zona. (Herdado de WebPart)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona informações sobre a imagem de fundo, alinhamento, envolvimento e direção à lista de atributos a renderizar. (Herdado de Panel)
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateChildControls()	Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização.
CreateControlCollection()	Sobrepõe o método base para criar uma coleção de apenas leitura que consiste no controlo filho envolto por um GenericWebPart controlo.
CreateControlStyle()	Cria um objeto de estilo que é usado internamente pelo Panel controlo para implementar todas as propriedades relacionadas com o estilo. (Herdado de Panel)
CreateEditorParts()	Devolve uma coleção de controlos personalizados EditorPart que podem ser usados para editar o controlo filho de um GenericWebPart controlo quando este está em modo de edição.
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Part)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior que foi guardado com o SaveViewState() método. (Herdado de WebControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MergeStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnClosing(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controlo está fechado numa página de Web Parts. (Herdado de WebPart)
OnConnectModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controlo está a iniciar ou terminar o processo de ligação a outros controlos. (Herdado de WebPart)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnDeleting(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controlo é removido permanentemente de uma página de Web Parts. (Herdado de WebPart)
OnEditModeChanged(EventArgs)	Permite que classes derivadas forneçam tratamento personalizado quando um WebPart controlo entra ou sai do modo de edição. (Herdado de WebPart)
OnInit(EventArgs)	Eleva o Init evento. (Herdado de Control)
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de Control)
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Delegados que entregam o conteúdo do controlo ao controlo criança.
RenderBeginTag(HtmlTextWriter)	Renderiza a etiqueta de abertura HTML do Panel controlo ao escritor especificado. (Herdado de Panel)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a etiqueta HTML de fecho do Panel controlo no escritor especificado. (Herdado de Panel)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Guarda qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado. (Herdado de WebControl)
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetPersonalizationDirty()	Define um flag indicando que os dados de personalização mudaram para a instância de controlo atual WebPart . (Herdado de WebPart)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o controlo acompanhe alterações ao estado de visualização para que possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebPart)

evento

Name	Description
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite ao desenvolvedor de um designer para um controlo de peça composta recriar os controlos filhos do controlo na superfície de design. (Herdado de Part)
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a recolha dos valores padrão para o controlo de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controlo de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Ver também

Comentários

Esta página foi útil?