DbDataAdapter Classe

Referência

Definição

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Origem:: DbDataAdapter.cs

Origem:: DbDataAdapter.cs

Origem:: DbDataAdapter.cs

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.

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: Object

MarshalByRefObject

Component

DataAdapter
DbDataAdapter

Derivado: System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementações: IDataAdapter IDbDataAdapter ICloneable

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
PrvDataAdapter()	Inicializa uma nova instância da classe PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Inicializa uma nova instância da classe PrvDataAdapter com a instrução SELECT do SQL especificada.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Inicializa uma nova instância da classe PrvDataAdapter com uma instrução SQL SELECT e um cadeia de conexão.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Inicializa uma nova instância da classe PrvDataAdapter com uma instrução SQL SELECT e um objeto PrvConnection.

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

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

Partilhar via