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 a seguir usa as classes SqlCommandSqlDataAdapter derivadas eSqlConnection, para selecionar registros de uma fonte de dados. 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 SELECT Transact-SQL.

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

Comentários

A IDbDataAdapter interface herda da IDataAdapter interface e permite que um objeto crie um DataAdapter projetado para uso com um banco de dados relacional. A IDbDataAdapter interface e, opcionalmente, a classe de utilitário, DbDataAdapterpermitem que uma classe herdada implemente uma classe DataAdapter, que representa a ponte entre uma fonte de dados e uma DataSet. Para obter mais informações sobre classes DataAdapter, consulte Populando um DataSet de um DataAdapter. Para obter mais informações sobre como implementar provedores de dados do .NET Framework, consulte Implementando um provedor de dados do .NET Framework.

Um aplicativo 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 herdadas IDbDataAdapter devem implementar os membros herdados e, normalmente, definir membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a IDbDataAdapter interface define a SelectCommand propriedade e a DbDataAdapter interface define um Fill método que usa um DataTable parâmetro como um parâmetro. Por sua vez, a OleDbDataAdapter classe herda a SelectCommand propriedade e o Fill método e também define duas sobrecargas adicionais do Fill método que tomam um objeto ADO Recordset como um parâmetro.

Notas aos Implementadores

Para promover a consistência entre os provedores de dados do .NET Framework, nomeie a classe herdada no formato Prv DataAdapter, onde Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados do .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.

Ao herdar da IDbDataAdapter interface, você deve implementar os seguintes construtores: