IDbDataAdapter Interface

Definição

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Derivado

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementações

IDataAdapter

Exemplos

O exemplo seguinte utiliza as classes derivadas, SqlCommand, SqlDataAdapter e SqlConnection, para selecionar registos de uma fonte de dados. O preenchimento DataSet é então devolvido. Para isso, o método recebe uma DataSet inicializada, uma cadeia de ligação e uma cadeia de consulta que é uma instrução Transact-SQL SELECT.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString)
{
    using (SqlConnection connection =
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

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

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Observações

A IDbDataAdapter interface herda da IDataAdapter interface e permite que um objeto crie um DataAdapter concebido para uso com uma base de dados relacional. A IDbDataAdapter interface e, opcionalmente, a classe utilitária, DbDataAdapter, permitem que uma classe herdadora implemente uma classe DataAdapter, que representa a ponte entre uma fonte de dados e um DataSet. Para mais informações sobre classes DataAdapter, consulte Preencher um DataSet a partir de um DataAdapter. Para mais informações sobre a implementação de fornecedores de dados .NET Framework, consulte Implementing a .NET Framework Data Provider.

Uma aplicação não cria uma instância da IDbDataAdapter interface diretamente, mas cria uma instância de uma classe que herda IDbDataAdapter e DbDataAdapter.

As classes que herdam IDbDataAdapter devem implementar os membros herdados, e normalmente definem membros adicionais para adicionar funcionalidades específicas do fornecedor. Por exemplo, a IDbDataAdapter interface define a SelectCommand propriedade, e a DbDataAdapter interface define um Fill método que toma a DataTable como parâmetro. Por sua vez, a OleDbDataAdapter classe herda a propriedade e o FillSelectCommand método, e também define duas sobrecargas adicionais do Fill método que tomam um objeto ADO Recordet como parâmetro.

Notas para Implementadores

Para promover a consistência entre .NET fornecedores de dados do Framework, nomeie a classe herdadora na forma Prv DataAdapter, onde Prv é o prefixo uniforme dado a todas as classes num determinado espaço de dados do fornecedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.

Quando herdas da IDbDataAdapter interface, deves implementar os seguintes construtores: