OdbcDataAdapter Classe

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

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

Origem:

OdbcDataAdapter.cs

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 sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

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

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

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, DeleteCommandUpdateCommande 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.

Propriedades

Nome	Description
DeleteCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para excluir registros na fonte de dados.
InsertCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para inserir novos registros na fonte de dados.
SelectCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para selecionar registros na fonte de dados.
UpdateCommand	Obtém ou define uma instrução SQL ou procedimento armazenado usado para atualizar registros na fonte de dados.

Eventos

Nome	Description
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().
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.

Confira também

• DataAdapters e DataReaders