IDbDataAdapter-Schnittstelle
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 Framework-Datenanbieter, die auf relationale Datenbanken zugreifen.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Interface IDbDataAdapter
Inherits IDataAdapter
'Usage
Dim instance As IDbDataAdapter
public interface IDbDataAdapter : IDataAdapter
public interface class IDbDataAdapter : IDataAdapter
public interface IDbDataAdapter extends IDataAdapter
public interface IDbDataAdapter extends IDataAdapter
Hinweise
Die IDbDataAdapter-Schnittstelle erbt von der IDataAdapter-Schnittstelle und ermöglicht einem Objekt das Erstellen eines DataAdapter, der mit einer relationalen Datenbank verwendet werden kann. Die IDbDataAdapter-Schnittstelle und optional die Unterstützungsklasse DbDataAdapter ermöglichen einer erbenden Klasse das Implementieren einer DataAdapter-Klasse, die eine Brücke zwischen einer Datenquelle und einem DataSet darstellt. Weitere Informationen über DataAdapter-Klassen finden Sie unter Auffüllen eines DataSet mit einem DataAdapter. Weitere Informationen über das Implementieren von .NET Framework-Datenanbietern finden Sie unter Implementing a .NET Framework Data Provider.
Eine Anwendung erstellt eine Instanz der IDbDataAdapter-Schnittstelle nicht direkt, sondern erstellt eine Instanz einer Klasse, die IDbDataAdapter und DbDataAdapter erbt.
Klassen, die IDbDataAdapter erben, müssen die geerbten Member implementieren. Sie definieren i. d. R. zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die IDbDataAdapter-Schnittstelle definiert z. B. die SelectCommand-Eigenschaft, und die DbDataAdapter-Schnittstelle definiert eine Fill-Methode, die eine DataTable als Parameter annimmt. Die OleDbDataAdapter-Klasse erbt wiederum die SelectCommand-Eigenschaft und die Fill-Methode. Sie definiert darüber hinaus zwei zusätzliche Überladungen der Fill-Methode, die ein ADO Recordset-Objekt als Parameter annehmen.
Hinweise für Implementierer Benennen Sie zur Förderung der Konsistenz unter den .NET Framework-Datenprovidern die erbende Klasse in der Form PrvDataAdapter, wobei Prv das einheitliche Präfix für alle Klassen in einem bestimmten Namespace von .NET Framework-Datenprovidern ist. Sql ist z. B. das Präfix der SqlDataAdapter-Klasse im System.Data.SqlClient-Namespace. Wenn Sie die IDbDataAdapter-Schnittstelle vererben, müssen 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. |
Beispiel
Im folgenden Beispiel werden mithilfe der abgeleiteten Klassen SqlCommand, SqlDataAdapter und SqlConnection Datensätze aus einer Datenquelle ausgewählt. Anschließend wird das gefüllte DataSet zurückgegeben. Dafür werden der Methode ein initialisiertes DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, die eine Transact-SQL-SELECT-Anweisung ist.
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
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;
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0