IDataAdapter Interfejs

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Umożliwia obiektowi implementowanie obiektu DataAdapter i reprezentuje zestaw metod i właściwości związanych z mapowaniem, które są używane do wypełniania i aktualizowania DataSet źródła danych oraz aktualizowania go.

IDbDataAdapter wystąpienia są przeznaczone dla źródeł danych, które są (lub podobne) relacyjnych baz danych z poleceniami tekstowymi (takimi jak Transact-SQL), podczas gdy IDataAdapter wystąpienia mogą używać dowolnego typu źródła danych.

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Pochodne

System.Data.Common.DataAdapter

System.Data.Common.DbDataAdapter

System.Data.IDbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Przykłady

W poniższym przykładzie użyto klas pochodnych , SqlCommand, SqlDataAdapteri SqlConnection, do wybierania rekordów z bazy danych. Następnie zostanie zwrócony wypełniony DataSet . W tym celu metoda jest przekazywana zainicjowana DataSet, parametry połączenia i ciąg zapytania, który jest instrukcją 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

Uwagi

Interfejs IDataAdapter umożliwia dziedziczonej klasie implementowanie klasy DataAdapter, która reprezentuje most między źródłem danych a klasą DataSet. Aby uzyskać więcej informacji na temat klas DataAdapter, zobacz Wypełnianie zestawu danych z elementu DataAdapter.

Aplikacja nie tworzy bezpośrednio wystąpienia interfejsu IDataAdapter , ale implementuje wystąpienie klasy dziedziczonej przez IDataAdapterklasę .

Klasy dziedziczone IDataAdapter muszą implementować dziedziczone elementy członkowskie i zwykle definiują dodatkowe elementy członkowskie w celu dodania funkcji specyficznych dla dostawcy. Na przykład interfejs definiuje metodęFill, IDataAdapter która przyjmuje DataSet jako parametr. Z kolei klasa dziedziczy metodęFill, a także definiuje dwa dodatkowe przeciążenia metody, OleDbDataAdapter które przyjmują obiekt zestawu rekordów Fill ADO jako parametr.

Uwagi dotyczące implementowania

Aby podwyższyć spójność wśród dostawców danych .NET Framework, nazwij klasę dziedziczą w postaci Prv DataAdapter, gdzie Prv jest jednolity prefiks nadany wszystkim klasom w określonej przestrzeni nazw dostawcy danych .NET Framework. Na przykład Sql jest prefiksem SqlDataAdapter klasy w System.Data.SqlClient przestrzeni nazw.

Po dziedziczeniu z interfejsu IDataAdapter należy zaimplementować następujące konstruktory:

Element	Opis
PrvDataAdapter()	Inicjuje nowe wystąpienie klasy PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Inicjuje nowe wystąpienie klasy PrvDataAdapter przy użyciu określonej instrukcji SQL SELECT.
PrvDataAdapter(ciąg selectCommandText, ciąg selectConnectionString)	Inicjuje nowe wystąpienie klasy PrvDataAdapter przy użyciu instrukcji SQL SELECT i parametry połączenia.
PrvDataAdapter(ciąg selectCommandText, PrvConnection selectConnection)	Inicjuje nowe wystąpienie klasy PrvDataAdapter przy użyciu instrukcji SQL SELECT i obiektu PrvConnection.

Właściwości

MissingMappingAction	Wskazuje lub określa, czy niezamapowane tabele źródłowe lub kolumny są przekazywane z ich nazwami źródłowymi w celu filtrowania lub zgłaszania błędu.
MissingSchemaAction	Wskazuje lub określa, czy brakujące tabele źródłowe, kolumny i ich relacje są dodawane do schematu zestawu danych, ignorowane lub powodują wystąpienie błędu.
TableMappings	Pobiera kolekcję wskazującą sposób mapowania tabeli źródłowej na tabelę zestawu danych.

Metody

Fill(DataSet)	Dodaje lub aktualizuje wiersze, aby pasować do tych w DataSet źródle danych przy użyciu DataSet nazwy i tworzy DataTable nazwę "Tabela".
FillSchema(DataSet, SchemaType)	DataTable Dodaje nazwę "Tabela" do określonego DataSet i konfiguruje schemat tak, aby był zgodny z tym w źródle danych na podstawie określonego SchemaTypeelementu .
GetFillParameters()	Pobiera parametry ustawione przez użytkownika podczas wykonywania instrukcji SQL SELECT.
Update(DataSet)	Wywołuje odpowiednie instrukcje INSERT, UPDATE lub DELETE dla każdego wstawionego, zaktualizowanego lub usuniętego DataTable wiersza w określonym DataSet z nazwy "Tabela".