IDbDataAdapter Schnittstelle
Definition
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 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
- Implementiert
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) |