OdbcDataAdapter Classe

Referência

Definição

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Pacote:: System.Data.Odbc v8.0.0

Pacote:: System.Data.Odbc v9.0.0-rc.1.24431.7

Origem:: OdbcDataAdapter.cs

Origem:: OdbcDataAdapter.cs

Origem:: OdbcDataAdapter.cs

Origem:: OdbcDataAdapter.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 com uma fonte de dados usados para preencher o DataSet e atualizar a fonte de dados. Essa classe não pode ser herdada.

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

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

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

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

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

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

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

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter

Herança: Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter
OdbcDataAdapter

Implementações: IDataAdapter IDbDataAdapter ICloneable

Exemplos

O exemplo a seguir usa OdbcCommand, OdbcDataAdaptere OdbcConnection para selecionar registros e preencher um DataSet com as linhas selecionadas.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Comentários

O OdbcDataAdapter serve como uma ponte entre uma DataSet fonte de dados e para recuperar e salvar dados. O OdbcDataAdapter 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 OdbcDataAdapter preenche um DataSet, ele cria as tabelas e colunas necessárias 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 OdbcDataAdapter 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.

Observação

Quando você chama o Fill método em uma fonte de dados que não tem uma coluna de chave primária, o OdbcDataAdapter tenta promover a coluna de restrição exclusiva para a chave primária. No processo, o OdbcDataAdapter marca a restrição exclusiva como não anulável. Esse comportamento funciona a menos que haja um valor nulo na coluna de restrição exclusiva. Se houver um valor nulo, o Fill método falhará com uma violação de restrição. Para evitar essa situação, não permita valores nulos na coluna de restrição exclusiva.

Observação

Devido às limitações de drivers ODBC nativos, apenas um DataTable é retornado quando você chama FillSchema. Isso é verdadeiro mesmo ao executar instruções do lote SQL das quais vários DataTable objetos seriam esperados.

O OdbcDataAdapter também inclui as propriedades , InsertCommand, DeleteCommand, UpdateCommande TableMappings para facilitar o SelectCommandcarregamento e a atualização de dados.

Construtores

OdbcDataAdapter()	Inicializa uma nova instância da classe OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Inicializa uma nova instância da classe OdbcDataAdapter com a instrução SQL SELECT especificada.
OdbcDataAdapter(String, OdbcConnection)	Inicializa uma nova instância da classe OdbcDataAdapter com a instrução SQL SELECT e um OdbcConnection.
OdbcDataAdapter(String, String)	Inicializa uma nova instância da classe OdbcDataAdapter com uma instrução SQL SELECT e uma cadeia de conexão.

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 usado para excluir registros na fonte 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. Obsoleto. Obsoleto. 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, 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[], 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 uma operação de atualização, após um comando ser executado na fonte de dados.
RowUpdating	Ocorre durante o Update(DataSet), após um comando ser executado com relação à fonte de dados.

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.

Aplica-se a

Confira também

DataAdapters e DataReaders

Compartilhar via