IDbDataAdapter Interfaccia

Definizione

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

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Derivato

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementazioni

IDataAdapter

Esempio

Nell'esempio seguente vengono usate le classi derivate, SqlCommand, SqlDataAdapter e SqlConnectionper selezionare i record da un'origine dati. Viene quindi restituito il riempimento DataSet . A tale scopo, il metodo viene passato a un oggetto inizializzato DataSet, a una stringa di connessione e a una stringa di query che è un'istruzione 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

Commenti

L'interfaccia IDbDataAdapter eredita dall'interfaccia IDataAdapter e consente a un oggetto di creare un Oggetto DataAdapter progettato per l'uso con un database relazionale. L'interfaccia IDbDataAdapter e, facoltativamente, la classe di utilità , DbDataAdapterconsentono a una classe che eredita di implementare una classe DataAdapter, che rappresenta il bridge tra un'origine dati e un oggetto DataSet. Per altre informazioni sulle classi DataAdapter, vedere Popolamento di un dataset da un dataadapter. Per altre informazioni sull'implementazione di provider di dati .NET Framework, vedere Implementazione di un provider di dati .NET Framework.

Un'applicazione non crea direttamente un'istanza dell'interfaccia, ma crea un'istanza IDbDataAdapter di una classe che eredita IDbDataAdapter e DbDataAdapter.

Le classi che ereditano IDbDataAdapter devono implementare i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IDbDataAdapter definisce la SelectCommand proprietà e l'interfaccia DbDataAdapter definisce un Fill metodo che accetta come parametro .DataTable A sua volta, la OleDbDataAdapter classe eredita la SelectCommand proprietà e il Fill metodo e definisce anche due overload aggiuntivi del Fill metodo che accettano un oggetto Recordset ADO come parametro.

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, denominare la classe che eredita nel formato Prv DataAdapter, dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico del provider di dati .NET Framework. Ad esempio, Sql è il prefisso della SqlDataAdapter classe nello spazio dei System.Data.SqlClient nomi .

Quando si eredita dall'interfaccia IDbDataAdapter , è necessario implementare i costruttori seguenti: