IDbDataAdapter Schnittstelle

Definition

Stellt eine Gruppe von befehlsbezogenen Eigenschaften dar, die zum Auffüllen des DataSet und zum Aktualisieren einer Datenquelle verwendet werden. Die Implementierung erfolgt durch .NET-Datenanbieter, die auf relationale Datenbanken zugreifen.

public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
    interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
Abgeleitet
Implementiert

Beispiele

Im folgenden Beispiel werden die abgeleiteten Klassen , SqlDataAdapter und SqlConnectionverwendet, SqlCommandum Datensätze aus einer Datenquelle auszuwählen. Die ausgefüllte DataSet wird dann zurückgegeben. Um dies zu erreichen, wird der -Methode eine initialisierte DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, bei der es sich um eine Select-Anweisung von Transact-SQL 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 IDbDataAdapter -Schnittstelle erbt von der IDataAdapter -Schnittstelle und ermöglicht es einem -Objekt, einen DataAdapter zu erstellen, der für die Verwendung mit einer relationalen Datenbank entwickelt wurde. Die IDbDataAdapter -Schnittstelle und optional die Hilfsprogrammklasse ermöglichen DbDataAdapteres 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. Weitere Informationen zum Implementieren von .NET Framework-Datenanbietern finden Sie unter Implementieren eines .NET Framework-Datenanbieters.

Eine Anwendung erstellt nicht direkt eine Instanz der IDbDataAdapter -Schnittstelle, sondern eine Instanz einer -Klasse, die und DbDataAdaptererbtIDbDataAdapter.

Klassen, die erben IDbDataAdapter , müssen die geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Beispielsweise definiert die IDbDataAdapter -Schnittstelle die SelectCommand -Eigenschaft, und die DbDataAdapter -Schnittstelle definiert eine Fill -Methode, die einen DataTable als Parameter akzeptiert. Im Gegenzug erbt die OleDbDataAdapter -Klasse die SelectCommand -Eigenschaft und 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. Beispielsweise Sql ist das Präfix der SqlDataAdapter -Klasse im System.Data.SqlClient -Namespace.

Wenn Sie von der IDbDataAdapter -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 mit der angegebenen SQL SELECT-Anweisung.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL SELECT-Anweisung und einem PrvConnection-Objekt.

Eigenschaften

DeleteCommand

Ruft eine SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset ab oder legt diese fest.

InsertCommand

Ruft eine SQL-Anweisung ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.

MissingMappingAction

Gibt an, ob nicht zugeordnete Quelltabellen oder Spalten mit ihren Quellnamen zum Filtern übergeben werden, oder ob ein Fehler ausgelöst wird.

(Geerbt von IDataAdapter)
MissingSchemaAction

Gibt an, ob fehlende Quelltabellen, Spalten und ihre Beziehungen dem Datasetschema hinzugefügt oder ignoriert werden, oder ob ein Fehler ausgelöst wird.

(Geerbt von IDataAdapter)
SelectCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle ausgewählt werden, oder legt diese fest.

TableMappings

Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.

(Geerbt von IDataAdapter)
UpdateCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle aktualisiert werden, oder legt diese fest.

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".

(Geerbt von IDataAdapter)
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.

(Geerbt von IDataAdapter)
GetFillParameters()

Ruft die Parameter ab, die vom Benutzer beim Ausführen einer SQL-SELECT-Anweisung festgelegt wurden.

(Geerbt von IDataAdapter)
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.

(Geerbt von IDataAdapter)

Gilt für: