OleDbDataAdapter Classe

Definição

Namespace:: System.Data.OleDb

Assembly:: System.Data.OleDb.dll

Assembly:: System.Data.dll

Pacote:: System.Data.OleDb v11.0.0-preview.2.26159.112

Origem:: OleDbDataAdapter.cs

Origem:: OleDbDataAdapter.cs

Origem:: OleDbDataAdapter.cs

Origem:: OleDbDataAdapter.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

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

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

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

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

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

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

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter

Herança: Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter
OleDbDataAdapter

Atributos: RequiresDynamicCodeAttribute

Implementações: IDataAdapter IDbDataAdapter ICloneable

Exemplos

O exemplo a seguir usa o OleDbCommand, OleDbDataAdapter e OleDbConnection, para selecionar registros de uma fonte de dados do Access e preencher um DataSet com as linhas selecionadas. Em seguida, o preenchimento DataSet é retornado. Para fazer isso, o método é passado por uma cadeia de conexão inicializada DataSete 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 fonte de dados e uma DataSet fonte de dados para recuperar e salvar dados. Ele OleDbDataAdapter fornece essa ponte usando Fill para carregar dados da fonte de dados no DataSete usar Update para enviar alterações feitas na DataSet parte de trás para a fonte de dados.

Quando o OleDbDataAdapter preenchimento de 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 OleDbDataAdapter criação do esquema do , incluindo informações de DataSetchave primária, antes de preenchê-lo com dados usando FillSchema. Para obter mais informações, consulte Como adicionar 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, não OleDbDataAdapter é possível definir corretamente a PrimaryKey propriedade em nenhum .DataTable Nesses casos, você deve especificar explicitamente as chaves primárias para tabelas DataSetno .

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

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

Campos

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

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 . (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	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. (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 anexados a isso 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 DbDataReader. (Herdado de DataAdapter)
InsertCommand	Obtém ou define uma instrução SQL ou 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 existente DataSet não corresponde aos dados de entrada. (Herdado de DataAdapter)
ReturnProviderSpecificTypes	Obtém ou define se o `Fill` método deve retornar valores específicos do provedor ou valores comuns em conformidade com CLS. (Herdado de DataAdapter)
SelectCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para selecionar registros na fonte de dados.
Site	Obtém ou define o ISite Component. (Herdado de Component)
TableMappings	Obtém uma coleção que fornece o mapeamento primário entre uma tabela de origem e uma DataTable. (Herdado de DataAdapter)
UpdateBatchSize	Obtém ou define um valor que habilita ou desabilita o suporte ao processamento em lote e especifica o número de comandos que podem ser executados em um lote. (Herdado de DbDataAdapter)
UpdateCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para atualizar registros na fonte de dados.

Métodos

Nome	Description
AddToBatch(IDbCommand)	Adiciona um IDbCommand ao lote atual. (Herdado de DbDataAdapter)
ClearBatch()	Remove todos os IDbCommand objetos do lote. (Herdado de DbDataAdapter)
CloneInternals()	Obsoleto. Obsoleto. Obsoleto. Obsoleto. Cria uma cópia dessa instância de 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, Int32, Int32, String, IDbCommand, CommandBehavior)	Adiciona ou atualiza linhas em um intervalo especificado para fazer a correspondência entre elas na fonte de dados usando os nomes da tabela de origem, a DataSet cadeia de comandos e o DataSet comportamento do comando. (Herdado de DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome. (Herdado de DbDataAdapter)
Fill(DataSet, Object, String)	Adiciona ou atualiza linhas para corresponder a DataSet elas em um ADO `Recordset` ou `Record` objeto usando o objeto ADO e o nome da tabela de origem especificados DataSet.
Fill(DataSet, String, IDataReader, Int32, Int32)	Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o DataSet, DataTablee IDataReader os nomes. (Herdado de DbDataAdapter)
Fill(DataSet, String)	Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados usando os nomes e DataTable os DataSet nomes. (Herdado de DbDataAdapter)
Fill(DataSet)	Adiciona ou atualiza linhas no DataSet. (Herdado de DbDataAdapter)
Fill(DataTable, IDataReader)	Adiciona ou atualiza linhas em uma DataTable para corresponder às da fonte de dados usando os nomes especificados DataTable IDataReader . (Herdado de DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Adiciona ou atualiza linhas em uma DataTable para corresponder àquelas na fonte de dados usando o especificado DataTablee CommandBehavior IDbCommand . (Herdado de DbDataAdapter)
Fill(DataTable, Object)	Adiciona ou atualiza linhas em um DataTable para corresponder a elas em um ADO `Recordset` ou `Record` objeto usando os objetos especificados DataTable e do ADO.
Fill(DataTable)	Adiciona ou atualiza linhas em um intervalo especificado para corresponder às DataSet da fonte de dados usando o DataTable nome. (Herdado de DbDataAdapter)
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. (Herdado de DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome. (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, IDbCommand, String, CommandBehavior)	Adiciona um DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType. (Herdado de DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Adiciona um DataTable ao especificado DataSet. (Herdado de DataAdapter)
FillSchema(DataSet, SchemaType, String)	Adiciona um DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType e DataTable. (Herdado de DbDataAdapter)
FillSchema(DataSet, SchemaType)	Adiciona uma DataTable "Tabela" nomeada ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base na especificada SchemaType. (Herdado de DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Adiciona um DataTable ao especificado DataSet. (Herdado de DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Configura o esquema do especificado DataTable com base nos valores especificados SchemaType, cadeia de caracteres de comando e CommandBehavior valores. (Herdado de DbDataAdapter)
FillSchema(DataTable, SchemaType)	Configura o esquema do especificado DataTable com base no especificado SchemaType. (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 em 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 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. (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 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)	Aciona o evento FillError. (Herdado de DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Gera o `RowUpdated` evento de um provedor de dados .NET. (Herdado de DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Gera o `RowUpdating` evento de um provedor de dados .NET. (Herdado de DbDataAdapter)
ResetFillLoadOption()	FillLoadOption Redefine para seu estado padrão e faz Fill(DataSet) com que ele seja respeitadoAcceptChangesDuringFill. (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 eles devem ser mantidos. (Herdado de DataAdapter)
TerminateBatching()	Termina 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[], 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 DataRow objetos especificada. (Herdado de DbDataAdapter)
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(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 nome especificado DataTable . (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 especificado DataSet. (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 especificado DataTable. (Herdado de DbDataAdapter)

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. (Herdado de DbDataAdapter)
RowUpdated	Ocorre durante Update(DataSet) depois que um comando é executado na fonte de dados. A tentativa de atualização é feita. Portanto, o evento ocorre.
RowUpdating	Ocorre durante Update(DataSet) antes de um comando ser executado na fonte de dados. A tentativa de atualização é feita. Portanto, o evento ocorre.

Implantações explícitas de interface

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

Aplica-se a

Confira também

DataAdapters e DataReaders

Comentários

Esta página foi útil?

Compartilhar via

OleDbDataAdapter Classe

Definição

Exemplos

Comentários

Construtores

Campos

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários