IDataAdapter Schnittstelle

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.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 , SqlDataAdapterund verwendetSqlConnection, SqlCommandum Datensätze aus einer Datenbank auszuwählen. Das gefüllte DataSet wird dann zurückgegeben. Hierzu wird die -Methode an eine initialisierte DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, bei der es sich um eine Transact-SQL SELECT-Anweisung handelt.

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 es einer erbenden Klasse, eine DataAdapter-Klasse zu implementieren, die die Brücke zwischen einer Datenquelle und einem DataSetdarstellt. Weitere Informationen zu DataAdapter-Klassen finden Sie unter Auffüllen eines DataSets aus einem DataAdapter.

Eine Anwendung erstellt nicht direkt einen instance der IDataAdapter Schnittstelle, sondern implementiert eine instance einer Klasse, die erbtIDataAdapter.

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

Hinweise für Ausführende

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse im Format Prv DataAdapter, wobei Prv das einheitliche Präfix ist, das allen Klassen in einem bestimmten .NET Framework-Datenanbieternamespace zugewiesen wird. Sql Beispielsweise ist 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 instance der PrvDataAdapter-Klasse.
PrvDataAdapter(PrvCommand selectCommand)	Initialisiert eine neue instance der PrvDataAdapter-Klasse mithilfe der angegebenen SQL SELECT-Anweisung.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Initialisiert eine neue instance der PrvDataAdapter-Klasse mithilfe einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection SelectConnection)	Initialisiert eine neue instance 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.