DataAdapter Classe

Definição

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

Representa um conjunto de comandos SQL e uma ligação à base de dados que são usados para preencher e DataSet atualizar a fonte de dados.

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

Observações

Serve DataAdapter como uma ponte entre um DataSet e uma fonte de dados para recuperar e guardar dados. Fornece DataAdapter esta ponte mapeando Fill, que altera os dados em para DataSet corresponder aos dados da fonte de dados, e Update, que altera os dados na fonte de dados para corresponder aos dados em .DataSet

Se estiver a ligar-se a uma base de dados SQL Server, pode aumentar o desempenho global usando o SqlDataAdapter juntamente com os seus objetos SqlCommand e SqlConnection associados. Para fontes de dados suportadas por OLE DB, use os DataAdapter objetos com os seus associados OleDbCommand e OleDbConnection . Para fontes de dados suportadas por ODBC, use o DataAdapter with its associated OdbcCommand and OdbcConnection objects. Para bases de dados Oracle, use com DataAdapter os seus objetos associados OracleCommand e OracleConnection .

Quando uma instância de DataAdapter é criada, as propriedades de leitura/escrita são definidas para valores iniciais. Para obter uma lista desses valores, consulte o DataAdapter construtor.

Construtores

Name Description
DataAdapter()

Inicializa uma nova instância da DataAdapter classe.
DataAdapter(DataAdapter)

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

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 .
AcceptChangesDuringUpdate

Obtém ou define se AcceptChanges() é chamado durante um Update(DataSet).
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.
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)
FillLoadOption

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

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

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

Obtém ou define se o Fill método deve devolver valores específicos do fornecedor ou valores comuns compatíveis com CLS.
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.

Métodos

Name Description
CloneInternals()
Obsoleto.
Obsoleto.
Obsoleto.

Cria uma cópia desta instância 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)
CreateTableMappings()

Cria um novo DataTableMappingCollection.
Dispose()

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)

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

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
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 .
Fill(DataSet)

Adiciona ou atualiza linhas no DataSet para corresponder às da fonte de dados.
Fill(DataTable, IDataReader)

Adiciona ou atualiza linhas no DataTable para corresponder às da fonte de dados usando o DataTable nome e o especificado IDataReader.
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.
FillSchema(DataSet, SchemaType, String, IDataReader)

Adiciona a DataTable ao especificado DataSet.
FillSchema(DataSet, SchemaType)

Adiciona a DataTable 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.
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.
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)

Invocado quando ocorre um erro durante um Fill.
ResetFillLoadOption()

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

Determina se a AcceptChangesDuringFill propriedade deve ser mantida.
ShouldSerializeFillLoadOption()

Determina se a FillLoadOption propriedade deve ser mantida.
ShouldSerializeTableMappings()

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

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

(Herdado de Component)
Update(DataSet)

Chama as respetivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou eliminada na especificada DataSet a partir de uma DataTable "Tabela" nomeada.

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.

Implementações de Interface Explícita

Name Description
IDataAdapter.TableMappings

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

Aplica-se a

Ver também