BaseDataBoundControl Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Serve como a classe base para controles que se associam a dados usando um controle de fonte de dados ASP.NET.

public ref class BaseDataBoundControl abstract : System::Web::UI::WebControls::WebControl

public abstract class BaseDataBoundControl : System.Web.UI.WebControls.WebControl

type BaseDataBoundControl = class
    inherit WebControl

Public MustInherit Class BaseDataBoundControl
Inherits WebControl

Herança

Object

Control

WebControl

BaseDataBoundControl

Derivado

System.Web.UI.WebControls.DataBoundControl

System.Web.UI.WebControls.HierarchicalDataBoundControl

Comentários

ASP.NET dá suporte a uma arquitetura de controles que permite que os controles do servidor Web se associem a dados de forma consistente. Os controles do servidor Web que se associam aos dados são chamados de controles associados a dados e as classes que facilitam essa associação são chamadas de controles de fonte de dados. Os controles associados a dados projetados para usar controles de fonte de dados ASP.NET derivam da classe de controle BaseDataBoundControl, que define a funcionalidade de controle associado a dados base.

Você pode usar os controles associados a dados fornecidos com ASP.NET, incluindo GridView, DetailsViewe TreeView, para executar a maioria das tarefas de desenvolvimento da Web que envolvem a exibição de dados. Em cenários em que esses controles não fornecem a funcionalidade necessária, você pode herdar das classes base DataBoundControl e HierarchicalDataBoundControl para implementar seu próprio controle de fonte de dados personalizado.

Embora qualquer classe que dê suporte às propriedades DataSource e DataSourceID e o método DataBind seja um controle associado a dados, a maioria ASP.NET controles associados a dados estendem as classes abstratas BaseDataBoundControl e DataBoundControl. Exceções notáveis incluem DataGrid, Repeatere os controles de DropDownList. Para obter mais informações sobre a associação de dados, consulte ASP.NET Mapa de Conteúdo de Acesso a Dados.

Construtores

BaseDataBoundControl()

Inicializa uma nova instância da classe BaseDataBoundControl.

Propriedades

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)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do objeto Page 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)
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
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)
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
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 propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
Context	Obtém o objeto HttpContext associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de Control)
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 objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura 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)
DataSource	Obtém ou define o objeto do qual o controle associado a dados recupera sua lista de itens de dados.
DataSourceID	Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados.
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
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. Essa propriedade é somente leitura. (Herdado de Control)
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)
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)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
Initialized	Obtém um valor que indica se o controle associado a dados foi inicializado.
IsBoundUsingDataSourceID	Obtém um valor que indica se a propriedade DataSourceID está definida.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsDataBindingAutomatic	Obtém um valor que indica se a associação de dados é automática.
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control)
IsUsingModelBinders	Quando implementado em uma classe derivada, obtém um valor que indica se o controle está usando associadores de modelo.
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 valor de propriedade ID. (Herdado de Control)
Page	Obtém uma referência à instância de Page 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)
RequiresDataBinding	Obtém ou define um valor que indica se o método DataBind() deve ser chamado.
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)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado como "desabilitado" quando a propriedade IsEnabled do controle é false.
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o valor HtmlTextWriterTag que corresponde 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 do servidor atual. (Herdado de Control)
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)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição 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)
Width	Obtém ou define a largura do controle do servidor Web. (Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)	Adiciona atributos HTML e estilos que precisam ser renderizados ao HtmlTextWriterTagespecificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à coleção Controls do objeto Control. (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 ControlCollection do controle do 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 entrega à propriedade Trace a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor de ClientID armazenado em 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 propriedade ClientIDMode da instância de controle atual e de qualquer controle filho para Inherit. (Herdado de Control)
ConfirmInitState()	Define o estado inicializado do controle associado a dados.
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo objeto Style 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. (Herdado de Control)
CreateControlCollection()	Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo usado internamente pela classe WebControl para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
DataBind()	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho.
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 evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes 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)
EnsureDataBound()	Chama o método DataBind() se a propriedade DataSourceID estiver definida e o controle associado a dados estiver marcado para exigir associação.
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 id especificado e um inteiro, especificados no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir essa versão do método FindControl. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro id especificado. (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 propriedade UniqueID 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 método SaveControlState(). (Herdado de Control)
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o método SaveViewState(). (Herdado de WebControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, 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)
OnDataBinding(EventArgs)	Gera o evento DataBinding. (Herdado de Control)
OnDataBound(EventArgs)	Gera o evento DataBound.
OnDataPropertyChanged()	Vincula novamente o controle associado a dados a seus dados depois que uma das propriedades de identificação da fonte de dados base é alterada.
OnInit(EventArgs)	Manipula o evento Init.
OnLoad(EventArgs)	Gera o evento Load. (Herdado de Control)
OnPagePreLoad(Object, EventArgs)	Define o estado inicializado do controle associado a dados antes que o controle seja carregado.
OnPreRender(EventArgs)	Manipula o evento PreRender.
OnUnload(EventArgs)	Gera o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
PerformSelect()	Quando substituído em uma classe derivada, controla como os dados são recuperados e associados ao controle.
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 coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o controle para o gravador HTML especificado. (Herdado de WebControl)
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza o conteúdo do controle 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 HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo para um objeto HtmlTextWriter fornecido 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 controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
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 método TrackViewState(). (Herdado de WebControl)
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
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 acompanhe as alterações no estado de exibição para que possam ser armazenadas na propriedade ViewState do objeto. (Herdado de WebControl)
ValidateDataSource(Object)	Quando substituído em uma classe derivada, verifica se o objeto ao qual um controle associado a dados se associa é aquele com o qual ele pode trabalhar.

Eventos

DataBinding	Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control)
DataBound	Ocorre depois que o controle do servidor é associado a uma fonte de dados.
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 objeto Page. (Herdado de Control)
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

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)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, consulte HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, consulte HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, consulte AddParsedSubObject(Object). (Herdado de Control)

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)	Obsoleto. Permite que a seleção seja mantida em controles de dados que dão suporte à seleção e à paginação.
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.

Confira também

• DataBoundControl
• HierarchicalDataBoundControl
• CompositeDataBoundControl