OleDbDataAdapter Classe

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.1.24431.7

Origem:

OleDbDataAdapter.cs

Representa um conjunto de comandos de dados 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 OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Herança

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

Implementações

IDataAdapter IDbDataAdapter ICloneable

Exemplos

O exemplo a seguir usa , OleDbCommandOleDbDataAdapter e OleDbConnection, para selecionar registros de uma fonte de dados do Access e preencher um DataSet com as linhas selecionadas. O preenchido DataSet é retornado. Para fazer isso, o método é passado um inicializado DataSet, uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SQL SELECT.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Comentários

O OleDbDataAdapter serve como uma ponte entre uma DataSet fonte de dados e para recuperar e salvar dados. O OleDbDataAdapter fornece essa ponte usando Fill para carregar dados da fonte de dados para o DataSete usando Update para enviar alterações feitas na DataSet parte de trás para a fonte de dados.

Quando o OleDbDataAdapter preencher um DataSet, ele criará as tabelas e colunas apropriadas para os dados retornados se eles ainda não existirem. No entanto, as informações de chave primária não são incluídas no esquema criado implicitamente, a menos que a MissingSchemaAction propriedade esteja definida como AddWithKey. Você também pode ter a criação OleDbDataAdapter do esquema do , incluindo informações de DataSetchave primária, antes de preenchê-lo com dados usando FillSchema. Para obter mais informações, consulte Adicionando restrições existentes a um Conjunto de Dados.

Observe que alguns provedores OLE DB, incluindo o provedor MSDataShape, não retornam informações de tabela base ou chave primária. Portanto, o OleDbDataAdapter não pode definir corretamente a PrimaryKey propriedade em nenhum criado DataTable. Nesses casos, você deve especificar explicitamente as chaves primárias para tabelas no DataSet.

O OleDbDataAdapter também inclui as SelectCommandpropriedades , InsertCommand, DeleteCommand, UpdateCommande TableMappings para facilitar o carregamento e a atualização de dados.

Quando você cria uma instância de OleDbDataAdapter, as propriedades são definidas como seus valores iniciais. Para obter uma lista desses valores, consulte o OleDbDataAdapter construtor .

Construtores

OleDbDataAdapter()	Inicializa uma nova instância da classe OleDbDataAdapter.
OleDbDataAdapter(OleDbCommand)	Inicializa uma nova instância da classe OleDbDataAdapter com o OleDbCommand especificado como a propriedade SelectCommand.
OleDbDataAdapter(String, OleDbConnection)	Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand.
OleDbDataAdapter(String, String)	Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand.

Campos

DefaultSourceTableName

O nome padrão usado pelo objeto DataAdapter para mapeamentos de tabela. (Herdado de DbDataAdapter)

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 uma instrução SQL ou um procedimento armazenado 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. (Herdado de DbDataAdapter)
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 uma instrução SQL ou um procedimento armazenado 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 uma instrução SQL ou um procedimento armazenado 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. (Herdado de DbDataAdapter)
UpdateCommand	Obtém ou define uma instrução SQL ou um procedimento armazenado usado para atualizar registros na fonte de dados.

Métodos

AddToBatch(IDbCommand)	Adiciona um IDbCommand ao lote atual. (Herdado de DbDataAdapter)
ClearBatch()	Remove todos os objetos IDbCommand do lote. (Herdado de DbDataAdapter)
CloneInternals()	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. (Herdado de DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa uma nova instância da classe RowUpdatingEventArgs. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExecuteBatch()	Executa o lote atual. (Herdado de DbDataAdapter)
Fill(DataSet)	Adiciona ou atualiza linhas no DataSet. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
Fill(DataSet, Object, String)	Adiciona ou atualiza linhas no DataSet para que correspondam às linhas em um objeto Recordset ou Record do ADO usando o DataSet, o objeto ADO e o nome da tabela de origem.
Fill(DataSet, String)	Adiciona ou atualiza linhas no DataSet para corresponder às existentes na fonte de dados usando os nomes DataSet e DataTable. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
Fill(DataTable)	Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o nome DataTable. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
Fill(DataTable, Object)	Adiciona ou atualiza linhas em um DataTable para que elas correspondam às linhas em um objeto Recordset ou Record ADO usando o DataTable especificado e objetos ADO.
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Retorna um IDataParameter de um dos comandos no lote atual. (Herdado de DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Retorna informações sobre uma tentativa de atualização individual dentro de uma atualização em lote maior. (Herdado de DbDataAdapter)
GetFillParameters()	Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT. (Herdado de DbDataAdapter)
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. (Herdado de 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. (Herdado de DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Gera o evento RowUpdated de um provedor de dados .NET. (Herdado de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Gera o evento RowUpdating de um provedor de dados .NET. (Herdado de DbDataAdapter)
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. (Herdado de 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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)
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. (Herdado de DbDataAdapter)

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. (Herdado de DbDataAdapter)
RowUpdated	Ocorre durante o Update(DataSet), após um comando ser executado na fonte de dados. Realiza-se a tentativa de atualização. Portanto, o evento ocorre.
RowUpdating	Ocorre durante o Update(DataSet), após um comando ser executado com relação à fonte de dados. Realiza-se a tentativa de atualização. Portanto, o evento ocorre.

Implantações explícitas de interface

ICloneable.Clone()	Para obter uma descrição desse membro, confira Clone().
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	Para obter uma descrição desse membro, confira DeleteCommand.
IDbDataAdapter.InsertCommand	Para obter uma descrição desse membro, confira InsertCommand.
IDbDataAdapter.SelectCommand	Para obter uma descrição desse membro, confira SelectCommand.
IDbDataAdapter.UpdateCommand	Para obter uma descrição desse membro, confira UpdateCommand.

Confira também

• DataAdapters e DataReaders