DbDataAdapter Classe

Definição

Espaço de Nomes:
System.Data.Common
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Facilita a implementação da IDbDataAdapter interface. Os herdeiros de DbDataAdapter implementam um conjunto de funções para fornecer tipagem forte, mas herdam a maior parte da funcionalidade necessária para implementar totalmente um DataAdapter.

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

Observações

A DbDataAdapter classe herda da DataAdapter classe e implementa a IDbDataAdapter interface. Ajuda uma classe a implementar um DataAdapter concebido para uso com uma base de dados relacional.

Uma aplicação não cria diretamente uma instância da DbDataAdapter classe, mas cria uma instância de uma classe que herda dela.

As classes que herdam DbDataAdapter devem implementar os membros herdados, e normalmente definem membros adicionais para adicionar funcionalidades específicas do fornecedor. 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 ADO Recordset como parâmetro.

Notas para Implementadores

Quando herda da DbDataAdapter classe, recomendamos que implemente os seguintes construtores:

Número 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 SQL SELECT especificada.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Inicializa uma nova instância da classe *Prv*DataAdapter com uma instrução SQL SELECT e uma cadeia de ligaçã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 os fornecedores de dados .NET Framework, deve nomear a classe herdadora na forma PrvDataAdapter, onde Prv é o prefixo uniforme dado a todas as classes num espaço de nomes específico de fornecedor de dados .NET Framework. Por exemplo, "Sql" é o prefixo da SqlDataAdapter classe no namespace System.Data.SqlClient .

Construtores

Name Description
DbDataAdapter()

Inicializa uma nova instância de uma classe DataAdapter .
DbDataAdapter(DbDataAdapter)

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

Campos

Name Description
DefaultSourceTableName

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

Propriedades

Name Description
AcceptChangesDuringFill

Recebe ou define um valor que indica se AcceptChanges() é chamado em a DataRow depois de ser adicionado a durante DataTable qualquer 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 gerar um evento.

(Herdado de Component)
Container

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

(Herdado de Component)
ContinueUpdateOnError

Recebe ou define um valor que especifica se deve gerar uma exceção quando é encontrado um erro durante uma atualização de linha.

(Herdado de DataAdapter)
DeleteCommand

Recebe ou define um comando para eliminar registos do conjunto de dados.
DesignMode

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

(Herdado de Component)
Events

Obtém a lista de gestores de eventos que estão ligados a isto 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 a partir do DbDataReader.

(Herdado de DataAdapter)
InsertCommand

Recebe ou define um comando usado para inserir novos registos na fonte de dados.
MissingMappingAction

Determina a ação a tomar quando os dados recebidos não têm uma tabela ou coluna correspondente.

(Herdado de DataAdapter)
MissingSchemaAction

Determina a ação a tomar quando o esquema existente DataSet não corresponde aos dados recebidos.

(Herdado de DataAdapter)
ReturnProviderSpecificTypes

Obtém ou define se o Fill método deve devolver valores específicos do fornecedor ou valores comuns compatíveis com CLS.

(Herdado de DataAdapter)
SelectCommand

Recebe ou define um comando usado para selecionar registos 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

Recebe ou define um valor que permite ou desativa o suporte ao processamento por lote, e especifica o número de comandos que podem ser executados num batch.
UpdateCommand

Recebe ou define um comando usado para atualizar registos na fonte de dados.

Métodos

Name Description
AddToBatch(IDbCommand)

Adiciona A IDbCommand ao lote atual.
ClearBatch()

Remove todos IDbCommand os objetos do lote.
CloneInternals()
Obsoleto.
Obsoleto.
Obsoleto.

Cria uma cópia desta instância de DataAdapter.

(Herdado de DataAdapter)
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

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

Inicializa uma nova instância da RowUpdatedEventArgs classe.
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa uma nova instância da RowUpdatingEventArgs classe.
CreateTableMappings()

Cria um novo DataTableMappingCollection.

(Herdado de DataAdapter)
Dispose()

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo DbDataAdapter e opcionalmente liberta os recursos geridos.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteBatch()

Executa o lote atual.
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Adiciona ou atualiza linhas num intervalo especificado em para DataSet corresponder às da fonte de dados usando os DataSet nomes das tabelas de origem, cadeia de comandos e comportamento de comandos.
Fill(DataSet, Int32, Int32, String)

Adiciona ou atualiza linhas num intervalo especificado no DataSet para corresponder às da fonte de dados usando os DataSet nomes e DataTable .
Fill(DataSet, String, IDataReader, Int32, Int32)

Adiciona ou atualiza linhas num intervalo especificado em para DataSet corresponder às da fonte de dados usando , DataSetDataTable, e IDataReader nomes.
Fill(DataSet, String, IDataReader, Int32, Int32)

Adiciona ou atualiza linhas num intervalo especificado no DataSet para corresponder às da fonte de dados usando os DataSet nomes e DataTable .

(Herdado de DataAdapter)
Fill(DataSet, String)

Adiciona ou atualiza linhas em para DataSet corresponder às da fonte de dados usando os DataSet nomes e DataTable .
Fill(DataSet)

Adiciona ou atualiza linhas no DataSet.
Fill(DataTable, IDataReader)

Adiciona ou atualiza linhas em a DataTable para corresponder às da fonte de dados usando os nomes especificados DataTableIDataReader .
Fill(DataTable, IDataReader)

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

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

Adiciona ou atualiza linhas em a DataTable para corresponder às da fonte de dados usando o especificado DataTable, IDbCommand e CommandBehavior.
Fill(DataTable)

Adiciona ou atualiza linhas num intervalo especificado no DataSet para corresponder às da fonte de dados usando o DataTable nome.
Fill(DataTable[], IDataReader, Int32, Int32)

Adiciona ou atualiza linhas num intervalo especificado na coleção de DataTable objetos para corresponder às da fonte de dados.

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

Adiciona ou atualiza linhas num intervalo especificado no DataSet para corresponder às da fonte de dados usando os DataSet nomes e DataTable .
Fill(Int32, Int32, DataTable[])

Adiciona ou atualiza linhas em um ou mais DataTable objetos para corresponder às da fonte de dados a partir do registo especificado e recuperando até ao número máximo de registos especificado.
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Adiciona a DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType.
FillSchema(DataSet, SchemaType, String, IDataReader)

Adiciona a DataTable ao especificado DataSet.

(Herdado de DataAdapter)
FillSchema(DataSet, SchemaType, String)

Adiciona a DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType e DataTable.
FillSchema(DataSet, SchemaType)

Adiciona uma DataTable "Tabela" nomeada ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType.
FillSchema(DataTable, SchemaType, IDataReader)

Adiciona a DataTable ao especificado DataSet.

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

Configura o esquema do especificado DataTable com base no especificado SchemaType, cadeia de comandos e CommandBehavior valores.
FillSchema(DataTable, SchemaType)

Configura o esquema do especificado DataTable com base no especificado SchemaType.
GetBatchedParameter(Int32, Int32)

Retorna a IDataParameter de um dos comandos do lote atual.
GetBatchedRecordsAffected(Int32, Int32, Exception)

Devolve informações sobre uma tentativa individual de atualização dentro de uma atualização em lote maior.
GetFillParameters()

Obtém os parâmetros definidos pelo utilizador ao executar uma instrução SQL SELECT.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetService(Type)

Devolve 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 agrupamento para o DbDataAdapter.
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Eleva o FillError evento.
OnFillError(FillErrorEventArgs)

Invocado quando ocorre um erro durante um Fill.

(Herdado de DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Levanta o evento RowUpdated de um fornecedor de dados .NET.
OnRowUpdating(RowUpdatingEventArgs)

Levanta o evento RowUpdating de um fornecedor de dados .NET.
ResetFillLoadOption()

Reinicia FillLoadOption para o seu estado padrão e causa Fill(DataSet) honrar AcceptChangesDuringFill.

(Herdado de DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Determina se a AcceptChangesDuringFill propriedade deve ser mantida.

(Herdado de DataAdapter)
ShouldSerializeFillLoadOption()

Determina se a FillLoadOption propriedade deve ser mantida.

(Herdado de DataAdapter)
ShouldSerializeTableMappings()

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

(Herdado de DataAdapter)
TerminateBatching()

Termina o agrupamento para o DbDataAdapter.
ToString()

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)
Update(DataRow[], DataTableMapping)

Atualiza os valores na base de dados executando as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada no array especificado de DataRow objetos.
Update(DataRow[])

Atualiza os valores na base de dados executando as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada no array especificado no DataSet.
Update(DataSet, String)

Atualiza os valores na base de dados executando as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada com DataSet o nome especificado DataTable .
Update(DataSet)

Atualiza os valores na base de dados executando as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada na linha especificada DataSet.
Update(DataTable)

Atualiza os valores na base de dados executando as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada na linha especificada DataTable.

evento

Name Description
Disposed

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

(Herdado de Component)
FillError

Devolvido quando ocorre um erro durante uma operação de preenchimento.
FillError

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

(Herdado de DataAdapter)

Implementações de Interface Explícita

Name Description
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 conjuntos de dados.

(Herdado de DataAdapter)
IDbDataAdapter.DeleteCommand

Obtém ou define uma instrução SQL para eliminar registos do conjunto de dados.
IDbDataAdapter.InsertCommand

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

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

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

Aplica-se a

Ver também