IDataAdapter-Schnittstelle
Ermöglicht einem Objekt das Implementieren eines DataAdapter und stellt eine Gruppe von Methoden und zuordnungsbezogenen Eigenschaften dar, mit denen ein DataSet gefüllt und aktualisiert sowie eine Datenquelle aktualisiert wird.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Interface IDataAdapter
'Usage
Dim instance As IDataAdapter
public interface IDataAdapter
public interface class IDataAdapter
public interface IDataAdapter
public interface IDataAdapter
Hinweise
Die IDataAdapter-Schnittstelle ermöglicht 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 implementiert eine Instanz einer Klasse, die IDbDataAdapter erbt.
Klassen, die IDataAdapter erben, müssen die geerbten Member implementieren. Sie definieren i. d. R. zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen. Die IDataAdapter-Schnittstelle definiert z. B. eine Fill-Methode, die ein DataSet als Parameter annimmt. Die OleDbDataAdapter-Klasse erbt wiederum die Fill-Methode und definiert außerdem 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 Prv DataAdapter, 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 IDataAdapter-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 Datenbank 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