IDbDataAdapter Interfejs

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Zestaw:

System.Data.dll

Zestaw:

netstandard.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 jest implementowany 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, do wybierania rekordów ze źródła danych. Wypełnione DataSet są następnie zwracane. W tym celu 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życia z relacyjną bazą danych. Interfejs IDbDataAdapter i, opcjonalnie, klasa narzędzia, DbDataAdapterumożliwia dziedziczonej klasy zaimplementowanie klasy DataAdapter, która reprezentuje most między źródłem danych i 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 .NET Framework Dostawca danych.

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 zwykle 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 parametr jako parametr. Z kolei OleDbDataAdapter klasa dziedziczy SelectCommand właściwość i Fill metodę, a także definiuje dwa dodatkowe przeciążenia metody, które przyjmują obiekt zestawu rekordów Fill ADO jako parametr.

Uwagi dotyczące implementowania

Aby podwyższyć spójność między dostawcami danych .NET Framework, nazwij klasę dziedzicującą 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.

Podczas dziedziczenia 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 za pomocą instrukcji SQL SELECT i obiektu 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 w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazwy i tworzy DataTable nazwę "Tabela". (Odziedziczone po IDataAdapter)
FillSchema(DataSet, SchemaType)	DataTable Dodaje do określonego DataSet elementu nazwę "Tabela" i konfiguruje schemat w taki sposób, 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 wierszu o nazwie "Tabela". (Odziedziczone po IDataAdapter)