BaseDataBoundControl Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Serve como 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
- Derivado
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 |
SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
TagKey |
Obtém o valor HtmlTextWriterTag que corresponde 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 |
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 |
FindControl(String) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro |
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. |