OdbcDataAdapter Classe

Definição

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

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

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 que são usadas para preencher 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 fonte de dados e uma DataSet fonte de dados para recuperar e salvar dados. Ele OdbcDataAdapter 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 OdbcDataAdapter preenchimento de 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 OdbcDataAdapter 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.

Observação

Quando você chama o Fill método em uma fonte de dados que não tem uma coluna de chave primária, tenta OdbcDataAdapter promover a coluna de restrição exclusiva para a chave primária. No processo, marca a OdbcDataAdapter 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 dos drivers ODBC nativos, apenas um DataTable é retornado quando você chama FillSchema. Isso é verdadeiro mesmo ao executar instruções em lotes SQL das quais seriam esperados vários DataTable objetos.

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

Construtores

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

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 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 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, 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)	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 uma operação de atualização depois que um comando é executado na fonte de dados.
RowUpdating	Ocorre durante Update(DataSet) antes de um comando ser executado na fonte de dados.

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

OdbcDataAdapter 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