IDataAdapter Schnittstelle

Definition

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.Allows an object to implement a DataAdapter, and represents a set of methods and mapping action-related properties that are used to fill and update a DataSet and update a data source.

IDbDataAdapter-Instanzen gelten für Datenquellen, die relationale Datenbanken mit Textbefehlen (wie Transact-SQL) sind (oder ihnen ähneln), während IDataAdapter-Instanzen jeden Datenquelltyp verwenden können.IDbDataAdapter instances are for data sources that are (or resemble) relational databases with textual commands (like Transact-SQL), while IDataAdapter instances could can use any type of data source.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Abgeleitet

Beispiele

Im folgenden Beispiel werden die abgeleiteten Klassen SqlCommand SqlDataAdapter,, und SqlConnectionverwendet, um Datensätze aus einer Datenbank auszuwählen.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. Der ausgefüllte DataSet wird dann zurückgegeben.The filled DataSet is then returned. Zu diesem Zweck wird der Methode eine initialisierte DataSet, eine Verbindungs Zeichenfolge und eine Abfrage Zeichenfolge, die eine Transact-SQL-SELECT-Anweisung ist, übermittelt.To do this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

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 IDataAdapter -Schnittstelle ermöglicht es einer erbenden Klasse, eine DataAdapter-Klasse zu implementieren, die die Bridge zwischen einer DataSetDatenquelle und einem darstellt.The IDataAdapter interface allows an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Weitere Informationen zu DataAdapter-Klassen finden Sie unter Auffüllen eines Datasets aus einem DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter.

Eine Anwendung erstellt nicht direkt eine Instanz der IDataAdapter Schnittstelle, sondern implementiert eine Instanz einer Klasse, die erbt. IDataAdapterAn application does not create an instance of the IDataAdapter interface directly, but implements an instance of a class that inherits IDataAdapter.

Klassen, die IDataAdapter erben, müssen die geerbten Member implementieren, und Sie definieren in der Regel zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Die IDataAdapter -Schnittstelle definiert z. Fill b. eine Methode DataSet , die einen als Parameter annimmt.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. Wiederum erbt die OleDbDataAdapter -Klasse die Fill -Methode und definiert außerdem zwei Fill zusätzliche über Ladungen der-Methode, die ein ADO-Recordset-Objekt als Parameter annehmen.In turn, the OleDbDataAdapter class inherits the Fill method and also defines two additional overloads of the Fill method that take an ADO Recordset object as a parameter.

Hinweise für Ausführende

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse Prv in der Form DataAdapter, wobei Prv das einheitliche Präfix ist, das für alle Klassen in einem bestimmten .NET Framework Datenanbieter-Namespace angegeben wird.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Beispielsweise Sql ist das Präfix SqlDataAdapter der-Klasse im System.Data.SqlClient -Namespace.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Wenn Sie von der IDataAdapter -Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:When you inherit from the IDataAdapter interface, you should implement the following constructors:

ElementItem BeschreibungDescription
PrvDataAdapter()PrvDataAdapter() Initialisiert eine neue Instanz der PrvDataAdapter-Klasse.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (PrvCommand SelectCommand)PrvDataAdapter(PrvCommand selectCommand) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse, indem die angegebene SQL SELECT-Anweisung verwendet wird.Initializes a new instance of the PrvDataAdapter class by using the specified SQL SELECT statement.
PrvDataAdapter (String selectCommandText, String selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL-SELECT-Anweisung und einer Verbindungs Zeichenfolge.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.
PrvDataAdapter (String selectCommandText, PrvConnection selectconnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse mit einer SQL-SELECT-Anweisung und einem PrvConnection-Objekt.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Eigenschaften

MissingMappingAction

Gibt an, ob nicht zugeordnete Quelltabellen oder Spalten mit ihren Quellnamen zum Filtern übergeben werden, oder ob ein Fehler ausgelöst wird.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

MissingSchemaAction

Gibt an, ob fehlende Quelltabellen, Spalten und ihre Beziehungen dem Datasetschema hinzugefügt oder ignoriert werden, oder ob ein Fehler ausgelöst wird.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

TableMappings

Gibt an, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.Indicates how a source table is mapped to a dataset table.

Methoden

Fill(DataSet)

Fügt dem DataSet unter Verwendung des DataSet-Namens Zeilen hinzu bzw. aktualisiert diese, um eine Übereinstimmung mit den Zeilen in der Datenquelle zu erzielen, und erstellt eine DataTable mit der Bezeichnung "Table".Adds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "Table".

FillSchema(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.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

GetFillParameters()

Ruft die Parameter ab, die vom Benutzer beim Ausführen einer SQL-SELECT-Anweisung festgelegt wurden.Gets the parameters set by the user when executing an SQL SELECT statement.

Update(DataSet)

Ruft für jede Zeile im angegebenen DataSet einer DataTable mit dem Namen "Table", die eingefügt, aktualisiert oder gelöscht wird, die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung auf.Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

Gilt für: