IDbDataAdapter Schnittstelle

Definition

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.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET Framework data providers that access relational databases.

public interface class IDbDataAdapter : System::Data::IDataAdapter
public interface IDbDataAdapter : System.Data.IDataAdapter
type IDbDataAdapter = interface
    interface IDataAdapter
Public Interface IDbDataAdapter
Implements IDataAdapter
Abgeleitet
Implementiert

Beispiele

Im folgenden Beispiel werden die abgeleiteten Klassen SqlCommand SqlDataAdapter , und SqlConnectionverwendet, um Datensätze aus einer Datenquelle auszuwählen.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. Der ausgefüllte DataSet wird dann zurückgegeben.The filled DataSet is then returned. Um dies zu erreichen, wird der Methode eine initialisierte DataSet, eine Verbindungs Zeichenfolge und eine Abfrage Zeichenfolge, die eine Transact-SQL-SELECT-Anweisung ist, übermittelt.To accomplish 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 IDbDataAdapter Schnittstelle erbt von IDataAdapter der-Schnittstelle und ermöglicht einem Objekt, einen DataAdapter zu erstellen, der für die Verwendung mit einer relationalen Datenbank entworfen wurde.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. Die IDbDataAdapter -Schnittstelle und optional die Utility- DbDataAdapterKlasse erlauben einer erbenden Klasse, eine DataAdapter-Klasse zu implementieren, die die Bridge zwischen einer Datenquelle und einem DataSetdarstellt.The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow 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. Weitere Informationen zum Implementieren von .NET Framework-Datenanbietern finden Sie unter Implementieren einer .NET Framework Datenanbieter.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Eine Anwendung erstellt nicht direkt eine Instanz der IDbDataAdapter Schnittstelle, sondern erstellt eine Instanz einer Klasse, die und DbDataAdaptererbt IDbDataAdapter .An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

Klassen, die IDbDataAdapter erben, müssen die geerbten Member implementieren und in der Regel zusätzliche Elemente definieren, um anbieterspezifische Funktionen hinzuzufügen.Classes that inherit IDbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Die IDbDataAdapter -Schnittstelle definiert z. SelectCommand b. die- DbDataAdapter Eigenschaft, und Fill die-Schnittstelle DataTable definiert eine Methode, die einen als Parameter annimmt.For example, the IDbDataAdapter interface defines the SelectCommand property, and the DbDataAdapter interface defines a Fill method that takes a DataTable as a parameter. Wiederum erbt die OleDbDataAdapter -Klasse die SelectCommand -Eigenschaft und die Fill -Methode und definiert Fill außerdem zwei zusätzliche über Ladungen der-Methode, die ein ADO-Recordset-Objekt als Parameter annehmen.In turn, the OleDbDataAdapter class inherits the SelectCommand property and 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 IDbDataAdapter -Schnittstelle erben, sollten Sie die folgenden Konstruktoren implementieren:When you inherit from the IDbDataAdapter 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 mit der angegebenen SQL SELECT-Anweisung.Initializes a new instance of the PrvDataAdapter class with 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 with 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 with an SQL SELECT statement and a PrvConnection object.

Eigenschaften

DeleteCommand

Ruft eine SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset ab oder legt diese fest.Gets or sets an SQL statement for deleting records from the data set.

InsertCommand

Ruft eine SQL-Anweisung ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.Gets or sets an SQL statement used to insert new records into the data source.

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.

(Geerbt von IDataAdapter)
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.

(Geerbt von IDataAdapter)
SelectCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle ausgewählt werden, oder legt diese fest.Gets or sets an SQL statement used to select records in the data source.

TableMappings

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

(Geerbt von IDataAdapter)
UpdateCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle aktualisiert werden, oder legt diese fest.Gets or sets an SQL statement used to update records in the data source.

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".

(Geerbt von IDataAdapter)
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.

(Geerbt von IDataAdapter)
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.

(Geerbt von IDataAdapter)
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".

(Geerbt von IDataAdapter)

Gilt für: