DataAdapter Classe

Definição

Representa um conjunto de comandos SQL e uma conexão de banco de dados usada para preencher DataSet e 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
Derivado
Implementações

Comentários

O DataAdapter serve como uma ponte entre uma fonte de dados e uma DataSet fonte de dados para recuperar e salvar dados. A DataAdapter ponte é fornecida pelo mapeamento Fill, que altera os dados na DataSet correspondência dos dados na fonte de dados e Update, que altera os dados na fonte de dados para corresponder aos dados na DataSet.

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

Quando uma instância é 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

Nome Description
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

Nome Description
AcceptChangesDuringFill

Obtém ou define um valor que indica se AcceptChanges() é chamado em um DataRow após ele ser adicionado ao DataTable durante qualquer uma 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

Obtém ou define um valor que especifica se uma exceção deve ser gerada quando um erro é encontrado 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 anexados a isso Component.

(Herdado de Component)
FillLoadOption

Obtém ou define o LoadOption que determina como o adaptador preenche o DataTableDbDataReader.

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 existente DataSet não corresponde aos dados de entrada.

ReturnProviderSpecificTypes

Obtém ou define se o Fill método deve retornar valores específicos do 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 uma DataTable.

Métodos

Nome Description
CloneInternals()
Obsoleto.
Obsoleto.
Obsoleto.

Cria uma cópia dessa instância 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)
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, String, IDataReader, Int32, Int32)

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

Fill(DataSet)

Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados.

Fill(DataTable, IDataReader)

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

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

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

FillSchema(DataSet, SchemaType, String, IDataReader)

Adiciona um DataTable ao especificado DataSet.

FillSchema(DataSet, SchemaType)

Adiciona um 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 um DataTable ao especificado DataSet.

GetFillParameters()

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

GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetLifetimeService()

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

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou por sua 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 um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

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

FillLoadOption Redefine para seu estado padrão e faz Fill(DataSet) com que ele seja respeitadoAcceptChangesDuringFill.

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 eles devem ser mantidos.

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 especificado DataSet de uma DataTable "Tabela".

Eventos

Nome Description
Disposed

Ocorre quando o componente é descartado por uma chamada para o Dispose() método.

(Herdado de Component)
FillError

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

Implantações explícitas de interface

Nome Description
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