IDbDataAdapter Interfejs

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Reprezentuje zestaw właściwości związanych z poleceniami, które są używane do wypełniania DataSet i aktualizowania źródła danych i są implementowane przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.

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

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Pochodne

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementuje

IDataAdapter

Przykłady

W poniższym przykładzie użyto klas pochodnych , SqlCommandSqlDataAdapter i SqlConnection, aby wybrać rekordy ze źródła danych. Następnie zostanie zwrócony wypełniony DataSet . Aby to osiągnąć, metoda jest przekazywana zainicjowana DataSet, parametry połączenia i parametry zapytania, które są 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 IDbDataAdapter dziedziczy z interfejsu IDataAdapter i umożliwia obiektowi utworzenie obiektu DataAdapter przeznaczonego do użytku z relacyjnej bazy danych. Interfejs IDbDataAdapter i, opcjonalnie, klasa narzędzia , DbDataAdapterumożliwia dziedziczonej klasy 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. Aby uzyskać więcej informacji na temat implementowania dostawców danych . NET Framework, zobacz Implementowanie dostawcy danych programu .NET Framework.

Aplikacja nie tworzy bezpośrednio wystąpienia interfejsu IDbDataAdapter , ale tworzy wystąpienie klasy dziedziczonej IDbDataAdapter i DbDataAdapter.

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

Uwagi dotyczące implementowania

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

Po dziedziczeniu z interfejsu IDbDataAdapter 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 z określoną instrukcją SQL SELECT.
PrvDataAdapter(ciąg selectCommandText, ciąg selectConnectionString)	Inicjuje nowe wystąpienie klasy PrvDataAdapter za pomocą instrukcji SQL SELECT i parametrów połączenia.
PrvDataAdapter(ciąg selectCommandText, PrvConnection selectConnection)	Inicjuje nowe wystąpienie klasy PrvDataAdapter z instrukcją SQL SELECT i obiektem PrvConnection.

Właściwości

DeleteCommand	Pobiera lub ustawia instrukcję SQL na potrzeby usuwania rekordów z zestawu danych.
InsertCommand	Pobiera lub ustawia instrukcję SQL używaną do wstawiania nowych rekordów do źródła danych.
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. (Odziedziczone po IDataAdapter)
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. (Odziedziczone po IDataAdapter)
SelectCommand	Pobiera lub ustawia instrukcję SQL używaną do wybierania rekordów w źródle danych.
TableMappings	Pobiera kolekcję wskazującą sposób mapowania tabeli źródłowej na tabelę zestawu danych. (Odziedziczone po IDataAdapter)
UpdateCommand	Pobiera lub ustawia instrukcję SQL używaną do aktualizowania rekordów w źródle 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". (Odziedziczone po IDataAdapter)
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 . (Odziedziczone po IDataAdapter)
GetFillParameters()	Pobiera parametry ustawione przez użytkownika podczas wykonywania instrukcji SQL SELECT. (Odziedziczone po IDataAdapter)
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". (Odziedziczone po IDataAdapter)