IDbDataAdapter Schnittstelle

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementiert: IDataAdapter

Beispiele

Im folgenden Beispiel werden die abgeleiteten Klassen SqlCommand SqlDataAdapter und SqlConnection, zum Auswählen von Datensätzen aus einer Datenquelle 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 IDbDataAdapter Schnittstelle erbt von der IDataAdapter Schnittstelle und ermöglicht es einem Objekt, ein DataAdapter zu erstellen, das für die Verwendung mit einer relationalen Datenbank entwickelt wurde. Die IDbDataAdapter Schnittstelle und optional die Hilfsklasse DbDataAdapterermöglichen es einer erbenden 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. Weitere Informationen zum Implementieren von .NET Framework Datenanbietern finden Sie unter Implementieren eines .NET Framework Datenanbieter.

Eine Anwendung erstellt keine Instanz der IDbDataAdapter Schnittstelle direkt, erstellt aber eine Instanz einer Klasse, die erbt IDbDataAdapter und DbDataAdapter.

Klassen, die erben, müssen die geerbten IDbDataAdapter Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Die Schnittstelle definiert beispielsweise IDbDataAdapter die SelectCommand Eigenschaft, und die DbDataAdapter Schnittstelle definiert eine Fill Methode, die einen DataTable Parameter verwendet. Die Klasse erbt wiederum OleDbDataAdapter die SelectCommand Eigenschaft und die Fill Methode und definiert auch zwei zusätzliche Überladungen der Fill Methode, die 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 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 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