IDataAdapter IDataAdapter IDataAdapter IDataAdapter Interface

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 wird die abgeleiteten Klassen SqlCommand, SqlDataAdapter, und SqlConnection, 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. Die ausgefüllte DataSet wird zurückgegeben.The filled DataSet is then returned. Zu diesem Zweck wird die Methode ein initialisiertes übergeben DataSet, eine Verbindungszeichenfolge, und eine Abfragezeichenfolge, die eine Transact-SQL SELECT-Anweisung ist.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 einer erbenden Klasse zum Implementieren einer DataAdapter-Klasse, die eine Brücke zwischen einer Datenquelle darstellt und einen DataSet.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 über DataAdapter-Klassen finden Sie unter Auffüllen eines Datasets mit einen "DataAdapter".For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter.

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

Klassen, die erben IDataAdapter die geerbten Member implementieren müssen, und in der Regel definieren, 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. Z. B. die IDataAdapter Schnittstelle definiert eine Fill Methode, eine DataSet als Parameter.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a 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 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

Benennen Sie die erbende Klasse in das Formular zur Förderung der Konsistenz zwischen .NET Framework-Datenanbieter Prv DataAdapter, in denen Prv ist das einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework Data Provider-Namespace.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. Z. B. Sql ist das Präfix der der SqlDataAdapter -Klasse in der System.Data.SqlClient Namespace.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Beim Erben von der IDataAdapter -Schnittstelle, implementieren Sie die folgenden Konstruktoren: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 unter Verwendung der angegebenen SQL-SELECT-Anweisung.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 unter Verwendung einer SQL SELECT-Anweisung und eine Verbindungszeichenfolge an.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.

PrvDataAdapter (Zeichenfolge SelectCommandText, PrvConnection SelectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Initialisiert eine neue Instanz der PrvDataAdapter-Klasse unter Verwendung 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 MissingMappingAction MissingMappingAction 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 MissingSchemaAction MissingSchemaAction 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 TableMappings TableMappings TableMappings

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

Methoden

Fill(DataSet) Fill(DataSet) Fill(DataSet) 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) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) 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() GetFillParameters() GetFillParameters() 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) Update(DataSet) Update(DataSet) 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: