Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

IDataAdapter-Schnittstelle

 

Veröffentlicht: Oktober 2016

Ermöglicht einem Objekt das implementieren einen DataAdapter und stellt einen Satz von Methoden und Zuordnungseigenschaften, mit denen füllen und Aktualisieren einer DataSet und Aktualisieren einer Datenquelle.

IDbDataAdapter -Instanzen sind für Datenquellen, die relationale Datenbanken mit textbasierten Befehle sind (oder ähneln) (z. B. Transact-SQL), während IDataAdapter Instanzen können jede Art von Datenquelle verwenden können.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

public interface IDataAdapter

NameBeschreibung
System_CAPS_pubpropertyMissingMappingAction

Gibt an, oder gibt an, ob nicht zugeordnete Quelltabellen oder Spalten mit ihren Quellnamen zum Filtern oder einen Fehler auslöst übergeben werden.

System_CAPS_pubpropertyMissingSchemaAction

Gibt an, oder gibt an, ob fehlende Quelltabellen, Spalten und deren Beziehungen die Dataset-Schemas ignoriert, hinzugefügt werden oder dazu führen, dass einen Fehler ausgelöst werden soll.

System_CAPS_pubpropertyTableMappings

Gibt an, wie eine Quelltabelle einer Dataset-Tabelle zugeordnet wird.

NameBeschreibung
System_CAPS_pubmethodFill(DataSet)

Hinzugefügt oder aktualisiert Zeilen in der DataSet entsprechend den in der Datenquelle mit den DataSet nennen, und erstellt eine DataTable mit dem Namen "Table".

System_CAPS_pubmethodFillSchema(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.

System_CAPS_pubmethodGetFillParameters()

Ruft die Parameter, die vom Benutzer festgelegt werden, wenn eine SQL SELECT-Anweisung ausgeführt.

System_CAPS_pubmethodUpdate(DataSet)

Ruft die entsprechenden INSERT-, Update- oder DELETE-Anweisungen für jede eingefügt, aktualisiert oder Zeile in der angegebenen gelöschte DataSet aus einem DataTable mit dem Namen "Table".

Die IDataAdapter Schnittstelle ermöglicht einer erbenden Klasse implementieren eine DataAdapter-Klasse, die eine Brücke zwischen einer Datenquelle darstellt und einen DataSet. Weitere Informationen über DataAdapter-Klassen finden Sie unter Auffüllen eines "DataSets" durch einen "DataAdapter".

Eine Anwendung erstellt eine Instanz der nicht die IDataAdapter -Schnittstelle direkt, sondern implementiert eine Instanz einer Klasse, erbt IDataAdapter.

Klassen, die erben IDataAdapter die geerbten Member implementieren muss, und in der Regel definieren, zusätzliche Member-anbieterspezifische Funktionen hinzuzufügen. Zum Beispiel die IDataAdapter Schnittstelle definiert eine Fill Methode, die eine DataSet als Parameter. Wiederum die OleDbDataAdapter -Klasse erbt die Fill Methode und definiert außerdem zwei zusätzliche Überladungen der Fill Methode, die ein ADO-Recordset-Objekt als Parameter akzeptieren.

Hinweise für Implementierer:

Benennen Sie zur Förderung der Konsistenz zwischen .NET Framework-Datenanbietern die erbende Klasse in der Form Prv DataAdapter, in denen Prv ist das einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework Data Provider-Namespace. Z. B. Sql ist das Präfix der SqlDataAdapter -Klasse in die System.Data.SqlClient Namespace.

Beim Erben von der IDataAdapter -Schnittstelle, 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 (SelectCommandText Zeichenfolge, Zeichenfolge SelectConnectionString)

Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.

PrvDataAdapter (Zeichenfolge SelectCommandText, PrvConnection SelectConnection)

Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL SELECT-Anweisung und einem PrvConnection-Objekt.

Im folgenden Beispiel wird die abgeleiteten Klassen SqlCommand, SqlDataAdapter, und SqlConnection, um Datensätze aus einer Datenbank auszuwählen. Die gefüllte DataSet wird zurückgegeben. Zu diesem Zweck wird der Methode ein initialisiertes übergeben DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge, 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;
    }
}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: