DbDataAdapter Klasse

Definition

Unterstützt die Implementierung der IDbDataAdapter-Schnittstelle. Vererber von DbDataAdapter implementieren verschiedene Funktion zur Bereitstellung einer starken Typisierung, aber vererben die meisten Funktionen, die benötigt werden, um einen DataAdapter vollständig zu implementieren.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable
Vererbung
Abgeleitet
Implementiert

Hinweise

Die DbDataAdapter Klasse erbt von der DataAdapter Klasse und implementiert die IDbDataAdapter Schnittstelle. Es hilft einer Klasse, einen DataAdapter zu implementieren, der für die Verwendung mit einer relationalen Datenbank entwickelt wurde.

Eine Anwendung erstellt keine Instanz der DbDataAdapter Klasse direkt, sondern erstellt eine Instanz einer Klasse, die davon erbt.

Klassen, die erben, müssen die geerbten DbDataAdapter Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Die Klasse definiert beispielsweise DbDataAdapter die SelectCommand Eigenschaft, und die DbDataAdapter Klasse definiert acht Überladungen der Fill Methode. Wiederum erbt die OleDbDataAdapter Klasse die Fill Methode und definiert auch zwei zusätzliche Überladungen Fill , die ein ADO Recordset-Objekt als Parameter verwenden.

Hinweise für Ausführende

Wenn Sie von der DbDataAdapter Klasse erben, wird empfohlen, die folgenden Konstruktoren zu implementieren:

Element BESCHREIBUNG
*Prv* DataAdapter() Initialisiert eine neue Instanz der *PrvDataAdapter-Klasse*.
*Prv* DataAdapter(*PrvCommand* *selectCommand*) Initialisiert eine neue Instanz der *PrvDataAdapter-Klasse* mit der angegebenen SQL SELECT-Anweisung.
*Prv* DataAdapter(string *selectCommandText*, string *selectConnectionString*) Initialisiert eine neue Instanz der *PrvDataAdapter-Klasse* mit einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.
*Prv* DataAdapter(string *selectCommandText*, *PrvConnection* *selectConnection selectConnection*) Initialisiert eine neue Instanz der *PrvDataAdapter-Klasse* mit einer SQL SELECT-Anweisung und einem *PrvConnection-Objekt*.

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, sollten Sie die erbende Klasse im Formular PrvDataAdapter benennen, wobei Prv das einheitliche Präfix ist, das allen Klassen in einem bestimmten .NET Framework Datenanbieternamespace zugewiesen wird. Beispielsweise ist "Sql" das Präfix der SqlDataAdapter Klasse im System.Data.SqlClient-Namespace .

Konstruktoren

DbDataAdapter()

Initialisiert eine neue Instanz einer DataAdapter Klasse.

DbDataAdapter(DbDataAdapter)

Initialisiert eine neue Instanz der DataAdapter Klasse aus einem vorhandenen Objekt desselben Typs.

Felder

DefaultSourceTableName

Der vom DataAdapter-Objekt verwendete Standardname für Tabellenzuordnungen.

Eigenschaften

AcceptChangesDuringFill

Ruft einen Wert ab, der angibt, ob AcceptChanges() für eine DataRow aufgerufen wird, nachdem diese bei einem der Fill-Vorgänge der DataTable hinzugefügt wurde, oder legt diesen fest.

(Geerbt von DataAdapter)
AcceptChangesDuringUpdate

Ruft ab oder legt fest, ob AcceptChanges() während eines Update(DataSet) aufgerufen wird.

(Geerbt von DataAdapter)
CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
ContinueUpdateOnError

Ruft einen Wert ab, der angibt, ob beim Auftreten eines Fehlers während der Aktualisierung von Zeilen eine Ausnahme ausgelöst werden soll, oder legt diesen fest.

(Geerbt von DataAdapter)
DeleteCommand

Ruft einen Befehl zum Löschen von Datensätzen aus dem Dataset ab oder legt diesen fest.

DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
FillCommandBehavior

Ruft das Verhalten des Befehls für das Füllen des Datenadapters ab oder dieses legt.

FillLoadOption

Ruft die LoadOption ab, die bestimmt, wie der Adapter die DataTable vom DbDataReader füllt, oder legt diese fest.

(Geerbt von DataAdapter)
InsertCommand

Ruft einen Befehl ab, der zum Einfügen neuer Datensätze in der Datenquelle verwendet wird, oder legt diesen fest.

MissingMappingAction

Bestimmt die Aktion, die ausgeführt werden soll, wenn für eingehende Daten keine entsprechende Tabelle oder Spalte vorhanden ist.

(Geerbt von DataAdapter)
MissingSchemaAction

Bestimmt die Aktion, die ausgeführt werden soll, wenn das vorhandene DataSet-Schema eingehenden Daten nicht entspricht.

(Geerbt von DataAdapter)
ReturnProviderSpecificTypes

Ruft ab oder legt fest, ob die Fill-Methode anbieterspezifische Werte oder allgemeine CLS-kompatible Werte zurückgeben soll.

(Geerbt von DataAdapter)
SelectCommand

Ruft einen Befehl ab, mit dem Datensätze in der Datenquelle ausgewählt werden, oder legt diesen fest.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
TableMappings

Ruft eine Auflistung ab, die die primäre Zuordnung zwischen einer Quelltabelle und einer .DataTable

(Geerbt von DataAdapter)
UpdateBatchSize

Ruft einen Wert ab oder legt einen Wert fest, mit dem die Batchverarbeitung aktiviert bzw. deaktiviert wird, und gibt die Anzahl der Befehle an, die pro Batch ausgeführt werden können.

UpdateCommand

Ruft einen Befehl ab, mit dem Datensätze in der Datenquelle aktualisiert werden, oder legt diesen fest.

Methoden

AddToBatch(IDbCommand)

Fügt im aktuellen Batch einen IDbCommand hinzu.

ClearBatch()

Entfernt alle IDbCommand-Objekte aus dem Batch.

CloneInternals()
Veraltet.
Veraltet.
Veraltet.
Veraltet.

Erstellt eine Kopie dieser Instanz von DataAdapter.

(Geerbt von DataAdapter)
CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialisiert eine neue Instanz der RowUpdatedEventArgs-Klasse.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialisiert eine neue Instanz der RowUpdatingEventArgs-Klasse.

CreateTableMappings()

Erstellt einen neuen DataTableMappingCollection.

(Geerbt von DataAdapter)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von DbDataAdapter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExecuteBatch()

Führt den aktuellen Batch aus.

Fill(DataSet)

Fügt Zeilen in DataSet hinzu oder aktualisiert diese.

Fill(DataSet, Int32, Int32, String)

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden.

Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Aktualisiert Zeilen in einem angegebenen Bereich im DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet, den Namen der Quelltabelle, die Befehlszeichenfolge und das Befehlsverhalten verwenden.

Fill(DataSet, String)

Aktualisiert Zeilen im DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden.

Fill(DataSet, String, IDataReader, Int32, Int32)

Aktualisiert Zeilen in einem angegebenen Bereich im DataSet oder fügt Zeilen hinzu, um anhand der Namen DataSet, DataTable und IDataReader Übereinstimmung mit den Zeilen in der Datenquelle zu erzielen.

Fill(DataSet, String, IDataReader, Int32, Int32)

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden.

(Geerbt von DataAdapter)
Fill(DataTable)

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den DataTable-Namen verwendet.

Fill(DataTable, IDataReader)

Aktualisiert Zeilen in einer DataTable oder fügt Zeilen hinzu, um anhand der angegebenen Namen DataTable und IDataReader Übereinstimmung mit den Zeilen in der Datenquelle zu erzielen.

Fill(DataTable, IDataReader)

Fügt der DataTable unter Verwendung des DataTable-Namens und des angegebenen IDataReader Zeilen hinzu bzw. aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen.

(Geerbt von DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

Aktualisiert Zeilen in einer DataTable oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, wobei die angegebenen Werte für DataTable, IDbCommand und CommandBehavior verwendet werden.

Fill(DataTable[], IDataReader, Int32, Int32)

Aktualisiert Zeilen in einem angegebenen Bereich in der Auflistung der DataTable-Objekte oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen.

(Geerbt von DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden.

Fill(Int32, Int32, DataTable[])

Fügt Zeilen in einem oder mehreren DataTable Objekten hinzu, um mit diesen in der Datenquelle ab dem angegebenen Datensatz zu übereinstimmen und bis zur angegebenen maximalen Anzahl von Datensätzen abzurufen oder zu aktualisieren.

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.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

Fügt dem angegebenen DataTable eine DataSet hinzu und konfiguriert das Schema auf der Grundlage des angegebenen SchemaTypeso, dass es mit dem Schema in der Datenquelle übereinstimmt.

FillSchema(DataSet, SchemaType, String)

Fügt dem angegebenen DataSet eine DataTable hinzu und konfiguriert das Schema auf der Grundlage des angegebenen SchemaType und der angegebenen DataTable so, dass es mit dem Schema in der Datenquelle übereinstimmt.

FillSchema(DataSet, SchemaType, String, IDataReader)

Fügt dem angegebenen DataTable eine DataSet hinzu.

(Geerbt von DataAdapter)
FillSchema(DataTable, SchemaType)

Konfiguriert das Schema der angegebenen DataTable auf der Grundlage des angegebenen SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

Fügt dem angegebenen DataTable eine DataSet hinzu.

(Geerbt von DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Konfiguriert das Schema der angegebenen DataTable auf der Grundlage des angegebenen SchemaType, der angegebenen Befehlszeichenfolge und der angegebenen CommandBehavior-Werte.

GetBatchedParameter(Int32, Int32)

Gibt einen IDataParameter von einem der Befehle im aktuellen Batch zurück.

GetBatchedRecordsAffected(Int32, Int32, Exception)

Gibt Informationen über einen einzelnen Updateversuch innerhalb eines größeren Updates im Batchmodus zurück.

GetFillParameters()

Ruft die Parameter ab, die vom Benutzer beim Ausführen einer SQL-SELECT-Anweisung festgelegt wurden.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HasTableMappings()

Gibt an, ob eine DataTableMappingCollection erstellt wurde.

(Geerbt von DataAdapter)
InitializeBatching()

Initialisiert die Batchverarbeitung für den DbDataAdapter.

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
OnFillError(FillErrorEventArgs)

Löst das FillError-Ereignis aus.

OnFillError(FillErrorEventArgs)

Wird aufgerufen, wenn während eines Fill ein Fehler auftritt.

(Geerbt von DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

Löst das RowUpdated-Ereignis eines .NET-Datenanbieters aus.

OnRowUpdating(RowUpdatingEventArgs)

Löst das RowUpdating-Ereignis eines .NET-Datenanbieters aus.

ResetFillLoadOption()

Setzt die FillLoadOption auf ihren Standardzustand zurück und erzwingt, dass Fill(DataSet)AcceptChangesDuringFill berücksichtigt.

(Geerbt von DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

Bestimmt, ob die AcceptChangesDuringFill-Eigenschaft beibehalten werden soll.

(Geerbt von DataAdapter)
ShouldSerializeFillLoadOption()

Bestimmt, ob die FillLoadOption-Eigenschaft beibehalten werden soll.

(Geerbt von DataAdapter)
ShouldSerializeTableMappings()

Bestimmt, ob ein oder mehrere DataTableMapping-Objekte vorhanden sind und ob diese beibehalten werden sollen.

(Geerbt von DataAdapter)
TerminateBatching()

Beendet die Batchverarbeitung für den DbDataAdapter.

ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)
Update(DataRow[])

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array in DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataRow[], DataTableMapping)

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array von DataRow-Objekten die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataSet)

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataSet, String)

Aktualisiert die Werte in der Datenbank, indem es die jeweiligen Anweisungen „Einfügen“, „Aktualisieren“ oder „Löschen“ für jede eingefügte, aktualisierte oder gelöschte Zeile in dem DataSet mit dem angegebenen DataTable-Namen ausführt.

Update(DataTable)

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataTable die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)
FillError

Wird zurückgegeben, wenn während eines Füllvorgangs ein Fehler auftritt.

FillError

Wird zurückgegeben, wenn während eines Füllvorgangs ein Fehler auftritt.

(Geerbt von DataAdapter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()
Veraltet.

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz darstellt.

IDataAdapter.TableMappings

Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.

(Geerbt von DataAdapter)
IDbDataAdapter.DeleteCommand

Ruft eine SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset ab oder legt diese fest.

IDbDataAdapter.InsertCommand

Ruft eine SQL-Anweisung ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.

IDbDataAdapter.SelectCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle ausgewählt werden, oder legt diese fest.

IDbDataAdapter.UpdateCommand

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle aktualisiert werden, oder legt diese fest.

Gilt für:

Siehe auch