IDataAdapter Schnittstelle

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Ermöglicht einem Objekt das Implementieren eines DataAdapter und stellt eine Gruppe von Methoden und zuordnungsbezogenen Eigenschaften dar, mit denen ein DataSet gefüllt und aktualisiert sowie eine Datenquelle aktualisiert wird.

IDbDataAdapter-Instanzen gelten für Datenquellen, die relationale Datenbanken mit Textbefehlen (wie Transact-SQL) sind (oder ihnen ähneln), während IDataAdapter-Instanzen jeden Datenquelltyp verwenden können.

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Abgeleitet

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

Beispiele

Im folgenden Beispiel werden die abgeleiteten Klassen, SqlCommand, SqlDataAdapterund SqlConnection, zum Auswählen von Datensätzen aus einer Datenbank verwendet. Die ausgefüllte DataSet Wird dann zurückgegeben. Dazu wird die Methode eine initialisierteDataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, die eine Transact-SQL SELECT-Anweisung ist.

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

Hinweise

Die IDataAdapter Schnittstelle ermöglicht eine geerbte Klasse, eine DataAdapter-Klasse zu implementieren, die die Brücke zwischen einer Datenquelle und einer .DataSet Weitere Informationen zu DataAdapter-Klassen finden Sie unter Auffüllen eines DataSets aus einem DataAdapter.

Eine Anwendung erstellt keine Instanz der IDataAdapter Schnittstelle direkt, implementiert jedoch eine Instanz einer Klasse, die erbt IDataAdapter.

Klassen, die erben, müssen die geerbten IDataAdapter Member implementieren, und sie definieren normalerweise zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die Schnittstelle definiert beispielsweise eine Fill Methode, IDataAdapter die einen DataSet Parameter verwendet. OleDbDataAdapter Die Klasse erbt wiederum die Fill Methode und definiert auch zwei zusätzliche Überladungen der Methode, die Fill ein ADO Recordset-Objekt als Parameter verwendet.

Hinweise für Ausführende

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse im Formular Prv DataAdapter, wobei es sich um das einheitliche Präfix handelt, das Prv allen Klassen in einem bestimmten .NET Framework Datenanbieternamespace zugewiesen ist. Ist beispielsweise Sql das Präfix der SqlDataAdapter Klasse im System.Data.SqlClient Namespace.

Wenn Sie von der IDataAdapter Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:

Element	Beschreibung
PrvDataAdapter()	Initialisiert eine neue Instanz der PrvDataAdapter-Klasse.
PrvDataAdapter(PrvCommand selectCommand)	Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mithilfe der angegebenen SQL SELECT-Anweisung.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mithilfe einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection selectConnection)	Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mithilfe einer SQL SELECT-Anweisung und eines PrvConnection-Objekts.

Eigenschaften

MissingMappingAction	Gibt an, ob nicht zugeordnete Quelltabellen oder Spalten mit ihren Quellnamen zum Filtern übergeben werden, oder ob ein Fehler ausgelöst wird.
MissingSchemaAction	Gibt an, ob fehlende Quelltabellen, Spalten und ihre Beziehungen dem Datasetschema hinzugefügt oder ignoriert werden, oder ob ein Fehler ausgelöst wird.
TableMappings	Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.

Methoden

Fill(DataSet)	Fügt dem DataSet unter Verwendung des DataSet-Namens Zeilen hinzu bzw. aktualisiert diese, um eine Übereinstimmung mit den Zeilen in der Datenquelle zu erzielen, und erstellt eine DataTable mit der Bezeichnung "Table".
FillSchema(DataSet, SchemaType)	Fügt eine DataTable namens „Tabelle“ zum angegebenen DataSet hinzu und konfiguriert das Schema auf der Grundlage des angegebenen SchemaType so, dass es mit dem Schema in der Datenquelle übereinstimmt.
GetFillParameters()	Ruft die Parameter ab, die vom Benutzer beim Ausführen einer SQL-SELECT-Anweisung festgelegt wurden.
Update(DataSet)	Ruft für jede Zeile im angegebenen DataSet einer DataTable mit dem Namen "Table", die eingefügt, aktualisiert oder gelöscht wird, die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung auf.