DbDataAdapter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
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 |
| 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 |
| OnRowUpdated(RowUpdatedEventArgs) |
Löst das |
| OnRowUpdating(RowUpdatingEventArgs) |
Löst das |
| 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. |