Freigeben über


DbDataAdapter Klasse

Definition

Unterstützt die Implementierung der IDbDataAdapter Schnittstelle. Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

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
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. Sie 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 von ihr erbt.

Klassen, die erben DbDataAdapter , müssen die geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen. Beispielsweise definiert die DbDataAdapter Klasse die SelectCommand Eigenschaft, und die DbDataAdapter Klasse definiert acht Überladungen der Fill Methode. Die Klasse erbt wiederum OleDbDataAdapter die Fill Methode und definiert auch zwei zusätzliche Überladungen, die Fill 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 *Prv*DataAdapter-Klasse.
*Prv*DataAdapter(*Prv*Command *selectCommand*) Initialisiert eine neue Instanz der *Prv*DataAdapter-Klasse mit der angegebenen SQL SELECT-Anweisung.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Initialisiert eine neue Instanz der *Prv*DataAdapter-Klasse mit einer SQL SELECT-Anweisung und einer Verbindungszeichenfolge.
*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Initialisiert eine neue Instanz der *Prv*DataAdapter-Klasse mit einer SQL SELECT-Anweisung und einem *Prv*Connection -Objekt.

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

Konstruktoren

Name Beschreibung
DbDataAdapter()

Initialisiert eine neue Instanz einer DataAdapter-Klasse .

DbDataAdapter(DbDataAdapter)

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

Felder

Name Beschreibung
DefaultSourceTableName

Der Standardname, der DataAdapter vom Objekt für Tabellenzuordnungen verwendet wird.

Eigenschaften

Name Beschreibung
AcceptChangesDuringFill

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob AcceptChanges() für einen DataRow Aufruf nach dem DataTable Hinzufügen während eines der Ausfüllvorgänge aufgerufen wird.

(Geerbt von DataAdapter)
AcceptChangesDuringUpdate

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

(Geerbt von DataAdapter)
CanRaiseEvents

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

(Geerbt von Component)
Container

Ruft das, das IContainer die Component.

(Geerbt von Component)
ContinueUpdateOnError

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Ausnahme generiert werden soll, wenn während einer Zeilenaktualisierung ein Fehler auftritt.

(Geerbt von DataAdapter)
DeleteCommand

Dient zum Abrufen oder Festlegen eines Befehls zum Löschen von Datensätzen aus dem Dataset.

DesignMode

Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind.

(Geerbt von Component)
FillCommandBehavior

Ruft das Verhalten des Befehls ab, der zum Ausfüllen des Datenadapters verwendet wird, oder legt dieses fest.

FillLoadOption

Dient zum Abrufen oder Festlegen der LoadOption , die bestimmt, wie der Adapter die DataTable aus dem DbDataReader.

(Geerbt von DataAdapter)
InsertCommand

Dient zum Abrufen oder Festlegen eines Befehls zum Einfügen neuer Datensätze in die Datenquelle.

MissingMappingAction

Bestimmt die Aktion, die ausgeführt werden soll, wenn eingehende Daten keine übereinstimmende Tabelle oder Spalte aufweisen.

(Geerbt von DataAdapter)
MissingSchemaAction

Bestimmt die auszuführende Aktion, wenn das vorhandene DataSet Schema nicht mit eingehenden Daten übereinstimmt.

(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

Dient zum Abrufen oder Festlegen eines Befehls zum Auswählen von Datensätzen in der Datenquelle.

Site

Dient zum ISite Abrufen oder Festlegen des Werts des Component.

(Geerbt von Component)
TableMappings

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

(Geerbt von DataAdapter)
UpdateBatchSize

Dient zum Abrufen oder Festlegen eines Werts, der die Batchverarbeitungsunterstützung aktiviert oder deaktiviert, und gibt die Anzahl der Befehle an, die in einem Batch ausgeführt werden können.

UpdateCommand

Dient zum Abrufen oder Festlegen eines Befehls zum Aktualisieren von Datensätzen in der Datenquelle.

Methoden

Name Beschreibung
AddToBatch(IDbCommand)

Fügt dem aktuellen Batch einen hinzu IDbCommand .

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, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(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 ein neues DataTableMappingCollection.

(Geerbt von DataAdapter)
Dispose()

Veröffentlicht alle ressourcen, die von der Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den DbDataAdapter verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
ExecuteBatch()

Führt den aktuellen Batch aus.

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

Fügt Zeilen in einem angegebenen Bereich in einem DataSet angegebenen Bereich hinzu oder aktualisiert sie, um die Zeilen in der Datenquelle mit den Namen und den DataSet Quelltabellennamen, Befehlszeichenfolgen und Befehlsverhalten abzugleichen.

Fill(DataSet, Int32, Int32, String)

Fügt Zeilen in einem angegebenen Bereich in DataSet einem angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den Namen und DataTable den DataSet Zeilen in der Datenquelle übereinzustimmen.

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

Fügt Zeilen in einem angegebenen Bereich in einem DataSet angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den DataSetDataTableNamen und den IDataReader betreffenden Zeilen in der Datenquelle übereinzustimmen.

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

Fügt Zeilen in einem angegebenen Bereich in DataSet einem angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den Namen und DataTable den DataSet Zeilen in der Datenquelle übereinzustimmen.

(Geerbt von DataAdapter)
Fill(DataSet, String)

Fügt Zeilen in der DataSet Datenquelle hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den DataSet Und DataTable Namen übereinzustimmen.

Fill(DataSet)

Fügt Zeilen in der DataSetDatei hinzu oder aktualisiert sie.

Fill(DataTable, IDataReader)

Fügt Zeilen in einer DataTable Zeile hinzu, die mit den angegebenen DataTable Und IDataReader Namen in der Datenquelle übereinstimmen sollen, oder aktualisiert sie.

Fill(DataTable, IDataReader)

Fügt Zeilen in der DataTable Datenquelle mit dem DataTable Namen und dem angegebenen IDataReaderNamen hinzu oder aktualisiert sie, um zeilen in der Datenquelle abzugleichen.

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

Fügt Zeilen in einer Zeile DataTable hinzu, die mit den Zeilen in der Datenquelle mit dem angegebenen und dem Angegebenen DataTableübereinstimmen sollen, IDbCommand oder CommandBehavioraktualisiert sie.

Fill(DataTable)

Fügt Zeilen in einem angegebenen Bereich in einem DataSet angegebenen Bereich hinzu oder aktualisiert sie, um die Zeilen in der Datenquelle mit dem DataTable Namen abzugleichen.

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

Fügt Zeilen in einem angegebenen Bereich in der Auflistung von DataTable Objekten hinzu oder aktualisiert sie, um mit denen in der Datenquelle übereinzustimmen.

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

Fügt Zeilen in einem angegebenen Bereich in DataSet einem angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den Namen und DataTable den DataSet Zeilen in der Datenquelle übereinzustimmen.

Fill(Int32, Int32, DataTable[])

Fügt Zeilen in einem oder DataTable mehreren Objekten hinzu oder aktualisiert sie, um mit denen in der Datenquelle ab dem angegebenen Datensatz übereinzustimmen und bis zur angegebenen maximalen Anzahl von Datensätzen abzurufen.

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

Fügt dem angegebenen Objekt einen DataTable Wert hinzu und konfiguriert das Schema so, dass es dem in der Datenquelle basierend auf dem angegebenen Entspricht entsprichtSchemaType.DataSet

FillSchema(DataSet, SchemaType, String, IDataReader)

Fügt dem angegebenen DataSetWert einen DataTable hinzu.

(Geerbt von DataAdapter)
FillSchema(DataSet, SchemaType, String)

Fügt dem angegebenen DataSet Objekt einen DataTable Wert hinzu und konfiguriert das Schema so, dass es dem in der Datenquelle basierend auf dem angegebenen SchemaType und DataTable.

FillSchema(DataSet, SchemaType)

Fügt der angegebenen DataSet Tabelle eine DataTable benannte Tabelle hinzu und konfiguriert das Schema so, dass es dem in der Datenquelle basierend auf dem angegebenen entsprichtSchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

Fügt dem angegebenen DataSetWert einen DataTable hinzu.

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

Konfiguriert das Schema des angegebenen Werts DataTable basierend auf der angegebenen SchemaTypeBefehlszeichenfolge und CommandBehavior werten.

FillSchema(DataTable, SchemaType)

Konfiguriert das Schema des angegebenen Werts DataTable basierend auf dem angegebenen SchemaType.

GetBatchedParameter(Int32, Int32)

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

GetBatchedRecordsAffected(Int32, Int32, Exception)

Gibt Informationen zu einem einzelnen Updateversuch innerhalb einer größeren Batchaktualisierung zurück.

GetFillParameters()

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

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

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

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird.

(Geerbt von Component)
GetType()

Ruft die 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 die DbDataAdapter.

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie der 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 Fehlers Fillein 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()

FillLoadOption Setzt auf seinen Standardzustand zurück und bewirktFill(DataSet), dass er berücksichtigt AcceptChangesDuringFillwird.

(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 mindestens ein DataTableMapping Objekt vorhanden ist und diese beibehalten werden sollen.

(Geerbt von DataAdapter)
TerminateBatching()

Beendet die Batchverarbeitung für die DbDataAdapter.

ToString()

Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden.

(Geerbt von Component)
Update(DataRow[], DataTableMapping)

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

Update(DataRow[])

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

Update(DataSet, String)

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

Update(DataSet)

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen Zeile DataSetausgeführt werden.

Update(DataTable)

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen Zeile DataTableausgeführt werden.

Ereignisse

Name Beschreibung
Disposed

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird.

(Geerbt von Component)
FillError

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

FillError

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

(Geerbt von DataAdapter)

Explizite Schnittstellenimplementierungen

Name Beschreibung
ICloneable.Clone()
Veraltet.

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

IDataAdapter.TableMappings

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

(Geerbt von DataAdapter)
IDbDataAdapter.DeleteCommand

Dient zum Abrufen oder Festlegen einer SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset.

IDbDataAdapter.InsertCommand

Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Einfügen neuer Datensätze in die Datenquelle verwendet wird.

IDbDataAdapter.SelectCommand

Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Auswählen von Datensätzen in der Datenquelle verwendet wird.

IDbDataAdapter.UpdateCommand

Dient zum Abrufen oder Festlegen einer SQL-Anweisung, die zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird.

Gilt für:

Weitere Informationen