Partilhar via


DbDataAdapter Classe

Definição

Ajuda na implementação da interface IDbDataAdapter. Os herdeiros de DbDataAdapter implementam um conjunto de funções para fornecer uma tipagem forte, mas herdam a maioria das funcionalidades necessárias para implementar um DataAdapter por completo.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable
Herança
Derivado
Implementações

Comentários

A DbDataAdapter classe herda da DataAdapter classe e implementa a IDbDataAdapter interface . Ele ajuda uma classe a implementar um DataAdapter projetado para uso com um banco de dados relacional.

Um aplicativo não cria uma instância da DbDataAdapter classe diretamente, mas cria uma instância de uma classe que herda dela.

As classes herdadas DbDataAdapter devem implementar os membros herdados e normalmente definir membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a DbDataAdapter classe define a SelectCommand propriedade e a DbDataAdapter classe define oito sobrecargas do Fill método . Por sua vez, a OleDbDataAdapter classe herda o Fill método e também define duas sobrecargas adicionais de Fill que tomam um objeto Recordset do ADO como um parâmetro.

Notas aos Implementadores

Ao herdar da DbDataAdapter classe , recomendamos que você implemente os seguintes construtores:

Item Descrição
*Prv*DataAdapter() Inicializa uma nova instância da classe *Prv*DataAdapter.
*Prv*DataAdapter(*Prv*Command *selectCommand*) Inicializa uma nova instância da classe *Prv*DataAdapter com a instrução SELECT do SQL especificada.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Inicializa uma nova instância da classe *Prv*DataAdapter com uma instrução SQL SELECT e um cadeia de conexão.
*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Inicializa uma nova instância da classe *Prv*DataAdapter com uma instrução SQL SELECT e um objeto *Prv*Connection.

Para promover a consistência entre .NET Framework provedores de dados, você deve nomear a classe herdada no formato PrvDataAdapter, em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework. Por exemplo, "Sql" é o prefixo da SqlDataAdapter classe no namespace System.Data.SqlClient .

Construtores

DbDataAdapter()

Inicializa uma nova instância de uma classe DataAdapter.

DbDataAdapter(DbDataAdapter)

Inicializa uma nova instância da DataAdapter classe de um objeto existente do mesmo tipo.

Campos

DefaultSourceTableName

O nome padrão usado pelo objeto DataAdapter para mapeamentos de tabela.

Propriedades

AcceptChangesDuringFill

Obtém ou define um valor que indica se AcceptChanges() é chamado em um DataRow após ter sido adicionado ao DataTable durante alguma das operações de Preenchimento.

(Herdado de DataAdapter)
AcceptChangesDuringUpdate

Obtém ou define se AcceptChanges() é chamado durante um Update(DataSet).

(Herdado de DataAdapter)
CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.

(Herdado de Component)
Container

Obtém o IContainer que contém o Component.

(Herdado de Component)
ContinueUpdateOnError

Obtém ou define um valor que especifica se uma exceção deve ser gerada quando for encontrado um erro durante uma atualização de linha.

(Herdado de DataAdapter)
DeleteCommand

Obtém ou define um comando para excluir registros do conjunto de dados.

DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.

(Herdado de Component)
FillCommandBehavior

Obtém ou define o comportamento do comando usado para preencher o adaptador de dados.

FillLoadOption

Obtém ou define o LoadOption que determina como o adaptador preenche o DataTable do DbDataReader.

(Herdado de DataAdapter)
InsertCommand

Obtém ou define um comando usado para inserir novos registros na fonte de dados.

MissingMappingAction

Determina a ação a ser tomada quando os dados de entrada não têm uma tabela ou coluna correspondente.

(Herdado de DataAdapter)
MissingSchemaAction

Determina a ação a ser tomada quando o esquema DataSet existente não coincide com os dados de entrada.

(Herdado de DataAdapter)
ReturnProviderSpecificTypes

Obtém ou define se o método Fill deve retornar valores específicos ao provedor ou valores comuns em conformidade com CLS.

(Herdado de DataAdapter)
SelectCommand

Obtém ou define um comando usado para selecionar registros na fonte de dados.

Site

Obtém ou define o ISite do Component.

(Herdado de Component)
TableMappings

Obtém uma coleção que fornece o mapeamento primário entre uma tabela de origem e um DataTable.

(Herdado de DataAdapter)
UpdateBatchSize

Obtém ou define um valor que habilita ou desabilita o suporte ao processamento de lote e especifica o número de comandos que podem ser executadas em um lote.

UpdateCommand

Obtém ou define um comando usado para atualizar registros na fonte de dados.

Métodos

AddToBatch(IDbCommand)

Adiciona um IDbCommand ao lote atual.

ClearBatch()

Remove todos os objetos IDbCommand do lote.

CloneInternals()
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.

Cria uma cópia dessa instância do DataAdapter.

(Herdado de DataAdapter)
CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa uma nova instância da classe RowUpdatedEventArgs.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa uma nova instância da classe RowUpdatingEventArgs.

CreateTableMappings()

Cria um novo DataTableMappingCollection.

(Herdado de DataAdapter)
Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbDataAdapter e opcionalmente libera os recursos gerenciados.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteBatch()

Executa o lote atual.

Fill(DataSet)

Adiciona ou atualiza linhas no DataSet.

Fill(DataSet, Int32, Int32, String)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o DataSet e nomes da tabela de origem, a cadeia de comando e o comportamento do comando.

Fill(DataSet, String)

Adiciona ou atualiza linhas no DataSet para corresponder às existentes na fonte de dados usando os nomes DataSet e DataTable.

Fill(DataSet, String, IDataReader, Int32, Int32)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para que correspondam àquelas na fonte de dados usando os nomes DataSet, DataTable e IDataReader.

Fill(DataSet, String, IDataReader, Int32, Int32)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable.

(Herdado de DataAdapter)
Fill(DataTable)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o nome DataTable.

Fill(DataTable, IDataReader)

Adiciona ou atualiza linhas em uma DataTable para que correspondam àquelas na fonte de dados usando os nomes DataTable e IDataReader especificados.

Fill(DataTable, IDataReader)

Adiciona ou atualiza linhas no DataTable para corresponder àquelas na fonte de dados usando o nome DataTable e o IDataReader especificado.

(Herdado de DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

Adiciona ou atualiza linhas em um DataTable para corresponder às existentes na fonte de dados usando o DataTable, IDbCommand e CommandBehavior especificados.

Fill(DataTable[], IDataReader, Int32, Int32)

Adiciona ou atualiza as linhas em um intervalo especificado na coleção de objetos DataTable para corresponder àquelas na fonte de dados.

(Herdado de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable.

Fill(Int32, Int32, DataTable[])

Adiciona ou atualiza linhas em um ou mais DataTable objetos para corresponder às da fonte de dados começando no registro especificado e recuperando até o número máximo de registros especificado.

FillSchema(DataSet, SchemaType)

Adiciona um DataTable com o nome “Tabela” ao DataSet especificado e configura o esquema para corresponder a eles na fonte de dados com base no SchemaType especificado.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base no SchemaType especificado.

FillSchema(DataSet, SchemaType, String)

Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base nos SchemaType e DataTable especificados.

FillSchema(DataSet, SchemaType, String, IDataReader)

Adiciona um DataTable ao DataSet especificado.

(Herdado de DataAdapter)
FillSchema(DataTable, SchemaType)

Configura o esquema do DataTable especificado com base no SchemaType especificado.

FillSchema(DataTable, SchemaType, IDataReader)

Adiciona um DataTable ao DataSet especificado.

(Herdado de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Configura o esquema do DataTable especificado com base no SchemaType, na cadeia de caracteres de comando e nos valores CommandBehavior especificados.

GetBatchedParameter(Int32, Int32)

Retorna um IDataParameter de um dos comandos no lote atual.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Retorna informações sobre uma tentativa de atualização individual dentro de uma atualização em lote maior.

GetFillParameters()

Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HasTableMappings()

Indica se um DataTableMappingCollection foi criado.

(Herdado de DataAdapter)
InitializeBatching()

Inicializa o envio em lote para o DbDataAdapter.

InitializeLifetimeService()
Obsoleto.

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.

(Herdado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Aciona o evento FillError.

OnFillError(FillErrorEventArgs)

Chamado quando ocorre um erro durante um Fill.

(Herdado de DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Gera o evento RowUpdated de um provedor de dados .NET.

OnRowUpdating(RowUpdatingEventArgs)

Gera o evento RowUpdating de um provedor de dados .NET.

ResetFillLoadOption()

Redefine FillLoadOption para seu estado padrão e faz com que Fill(DataSet) honre AcceptChangesDuringFill.

(Herdado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Determina se a propriedade AcceptChangesDuringFill deve ser persistida.

(Herdado de DataAdapter)
ShouldSerializeFillLoadOption()

Determina se a propriedade FillLoadOption deve ser persistida.

(Herdado de DataAdapter)
ShouldSerializeTableMappings()

Determina se um ou mais objetos DataTableMapping existem e se devem ser persistidos.

(Herdado de DataAdapter)
TerminateBatching()

Encerra o envio em lote para o DbDataAdapter.

ToString()

Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído.

(Herdado de Component)
Update(DataRow[])

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída na matriz especificada no DataSet.

Update(DataRow[], DataTableMapping)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída na matriz de objetos DataRow especificada.

Update(DataSet)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet especificado.

Update(DataSet, String)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet com o nome DataTable especificado.

Update(DataTable)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataTable especificado.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().

(Herdado de Component)
FillError

É retornado quando ocorre um erro durante uma operação de preenchimento.

FillError

É retornado quando ocorre um erro durante uma operação de preenchimento.

(Herdado de DataAdapter)

Implantações explícitas de interface

ICloneable.Clone()
Obsoleto.

Cria um novo objeto que é uma cópia da instância atual.

IDataAdapter.TableMappings

Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados.

(Herdado de DataAdapter)
IDbDataAdapter.DeleteCommand

Obtém ou define uma instrução SQL para excluir registros do conjunto de dados.

IDbDataAdapter.InsertCommand

Obtém ou define uma instrução SQL usada para inserir novos registros na fonte de dados.

IDbDataAdapter.SelectCommand

Obtém ou define uma instrução SQL usada para selecionar registros na fonte de dados.

IDbDataAdapter.UpdateCommand

Obtém ou define uma instrução SQL usada para atualizar registros na fonte de dados.

Aplica-se a

Confira também