IDbDataAdapter Schnittstelle

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Quelle:

IDbDataAdapter.cs

Stellt einen Satz befehlsbezogener Eigenschaften dar, die zum Ausfüllen DataSet und Aktualisieren einer Datenquelle verwendet werden und von .NET-Datenanbietern implementiert werden, 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 SqlCommandSqlDataAdapter und SqlConnection,, um Datensätze aus einer Datenquelle auszuwählen. Die Ausgefüllte DataSet wird dann zurückgegeben. Hierzu wird die Methode an eine initialisierte DataSet, 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, einen DataAdapter zu erstellen, der für die Verwendung mit einer relationalen Datenbank entwickelt wurde. Die IDbDataAdapter Schnittstelle und optional die Hilfsklasse DbDataAdapterermöglichen es einer geerbten 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-Datenanbieters.

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

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 Parameter verwendet. Die Klasse erbt wiederum OleDbDataAdapter die SelectCommand Eigenschaft und 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 Format Prv DataAdapter, wobei Prv das einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework-Datenanbieternamespace angegeben 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)	Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL SELECT-Anweisung und einem PrvConnection -Objekt.

Eigenschaften

Name	Beschreibung
DeleteCommand	Dient zum Abrufen oder Festlegen einer SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset.
InsertCommand	Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Einfügen neuer Datensätze in die Datenquelle verwendet wird.
MissingMappingAction	Gibt an, ob nicht zugeordnete Quelltabellen oder -spalten mit ihren Quellnamen übergeben werden, um gefiltert oder einen Fehler auszulösen. (Geerbt von IDataAdapter)
MissingSchemaAction	Gibt an, ob fehlende Quelltabellen, Spalten und ihre Beziehungen dem Datasetschema hinzugefügt, ignoriert oder verursacht werden, dass ein Fehler ausgelöst wird. (Geerbt von IDataAdapter)
SelectCommand	Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Auswählen von Datensätzen in der Datenquelle verwendet wird.
TableMappings	Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird. (Geerbt von IDataAdapter)
UpdateCommand	Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird.

Methoden

Name	Beschreibung
Fill(DataSet)	Fügt Zeilen in der DataSet Datenquelle mithilfe des Namens hinzu oder aktualisiert sie, um zeilenweise mit denen DataSet in der Datenquelle übereinzustimmen, und erstellt eine DataTable benannte "Tabelle". (Geerbt von IDataAdapter)
FillSchema(DataSet, SchemaType)	Fügt der angegebenen DataSet Tabelle eine DataTable benannte Tabelle hinzu und konfiguriert das Schema so, dass es dem in der Datenquelle basierend auf dem angegebenen entsprichtSchemaType. (Geerbt von IDataAdapter)
GetFillParameters()	Ruft die vom Benutzer beim Ausführen einer SQL SELECT-Anweisung festgelegten Parameter ab. (Geerbt von IDataAdapter)
Update(DataSet)	Ruft die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen DataSet aus einer DataTable benannten "Tabelle" auf. (Geerbt von IDataAdapter)