Partilhar via


DataAdapter Classe

Definição

Representa um conjunto de comandos SQL e uma conexão de banco de dados que são usados para preencher o DataSet e atualizar a fonte de dados.

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

Comentários

O DataAdapter serve como uma ponte entre um DataSet e uma fonte de dados para recuperar e salvar dados. O DataAdapter fornece essa ponte mapeando Fill, que altera os dados no DataSet para corresponder aos dados na fonte de dados e Update, que altera os dados na fonte de dados para corresponder aos dados no DataSet.

Se você estiver se conectando a um banco de dados SQL Server, poderá aumentar o desempenho geral usando o SqlDataAdapter junto com seus objetos e SqlConnection associadosSqlCommand. Para fontes de dados com suporte do OLE DB, use o DataAdapter com seus objetos e OleDbConnection associadosOleDbCommand. Para fontes de dados compatíveis com ODBC, use o DataAdapter com seus objetos e OdbcConnection associadosOdbcCommand. Para bancos de dados Oracle, use o DataAdapter com seus objetos e OracleConnection associadosOracleCommand.

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

Construtores

DataAdapter()

Inicializa uma nova instância da classe DataAdapter.

DataAdapter(DataAdapter)

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

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.

AcceptChangesDuringUpdate

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

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.

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)
FillLoadOption

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

MissingMappingAction

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

MissingSchemaAction

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

ReturnProviderSpecificTypes

Obtém ou define se o método Fill deve retornar valores específicos ao provedor ou valores comuns em conformidade 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

CloneInternals()
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.

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

Cria um novo DataTableMappingCollection.

Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

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

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Fill(DataSet)

Adiciona ou atualiza linhas no DataSet para correspondência na fonte de dados.

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.

Fill(DataTable, IDataReader)

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

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.

FillSchema(DataSet, SchemaType)

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

FillSchema(DataSet, SchemaType, String, IDataReader)

Adiciona um DataTable ao DataSet especificado.

FillSchema(DataTable, SchemaType, IDataReader)

Adiciona um DataTable ao DataSet especificado.

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.

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)

Chamado quando ocorre um erro durante um Fill.

ResetFillLoadOption()

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

ShouldSerializeAcceptChangesDuringFill()

Determina se a propriedade AcceptChangesDuringFill deve ser persistida.

ShouldSerializeFillLoadOption()

Determina se a propriedade FillLoadOption deve ser persistida.

ShouldSerializeTableMappings()

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

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(DataSet)

Chama as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet especificado em um DataTable denominado “Tabela.”

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.

Implantações explícitas de interface

IDataAdapter.TableMappings

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

Aplica-se a

Confira também