IDbDataAdapter IDbDataAdapter IDbDataAdapter IDbDataAdapter Interface

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 wird die abgeleiteten Klassen SqlCommand, SqlDataAdapter und SqlConnection, 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. Die ausgefüllte DataSet wird zurückgegeben.The filled DataSet is then returned. Um dies zu erreichen, wird die Methode ein initialisiertes übergeben DataSet, eine Verbindungszeichenfolge, und eine Abfragezeichenfolge, die eine Transact-SQL SELECT-Anweisung ist.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 der IDataAdapter Schnittstelle und ermöglicht einem Objekt, das Erstellen eines DataAdapter für die Verwendung mit einer relationalen Datenbank.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 Hilfsprogrammklasse DbDataAdapter, ermöglichen einer erbenden Klasse zum Implementieren einer DataAdapter-Klasse, die eine Brücke zwischen einer Datenquelle darstellt und einen DataSet.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 ü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. Weitere Informationen zu .NET Framework-Datenanbietern implementiert, finden Sie unter Implementieren eines .NET Framework-Datenanbieters.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Eine Anwendung erstellt eine Instanz der keine der IDbDataAdapter -Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die erbt IDbDataAdapter und DbDataAdapter.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 erben IDbDataAdapter müssen Sie die geerbten Member implementieren und definieren Sie in der Regel zusätzliche Member, um anbieterspezifische Funktionen hinzuzufügen.Classes that inherit IDbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Z. B. die IDbDataAdapter Schnittstelle definiert die SelectCommand -Eigenschaft, und die DbDataAdapter Schnittstelle definiert eine Fill Methode, eine DataTable als Parameter.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 die OleDbDataAdapter -Klasse erbt die SelectCommand Eigenschaft und 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 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

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 IDbDataAdapter -Schnittstelle, implementieren Sie die folgenden Konstruktoren:When you inherit from the IDbDataAdapter interface, you should implement the following constructors:

ElementItem Beschreibung Description
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 eine Verbindungszeichenfolge an.Initializes a new instance of the PrvDataAdapter class with 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 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 DeleteCommand DeleteCommand 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 InsertCommand InsertCommand 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 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.

(Inherited from IDataAdapter)
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.

(Inherited from IDataAdapter)
SelectCommand SelectCommand SelectCommand 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 TableMappings TableMappings TableMappings

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

(Inherited from IDataAdapter)
UpdateCommand UpdateCommand UpdateCommand 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) 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".

(Inherited from IDataAdapter)
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.

(Inherited from IDataAdapter)
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.

(Inherited from IDataAdapter)
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".

(Inherited from IDataAdapter)

Gilt für: