DataAdapter 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.
Stellt einen Satz von SQL-Befehlen und eine Datenbankverbindung dar, die verwendet werden, um das DataSet aufzufüllen und die Datenquelle zu aktualisieren.
public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapterpublic ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapterpublic class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapterpublic abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdaptertype DataAdapter = class
inherit Component
interface IDataAdapterPublic Class DataAdapter
Inherits Component
Implements IDataAdapterPublic MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter- Vererbung
- Abgeleitet
- Implementiert
Hinweise
Dient DataAdapter als Brücke zwischen einer DataSet und einer Datenquelle zum Abrufen und Speichern von Daten. DataAdapter stellt diese Brücke durch Zuordnung Fillzur Verfügung, wodurch die Daten im DataSet so geändert werden, dass sie den Daten in der Datenquelle entsprechen, und Update, wodurch die Daten in der Datenquelle so geändert werden, dass sie mit den Daten in übereinstimmenDataSet.
Wenn Sie eine Verbindung mit einer SQL Server-Datenbank herstellen, können Sie die Gesamtleistung erhöhen, indem Sie die zusammen mit den SqlDataAdapter zugehörigen SqlCommand Objekten und SqlConnection verwenden. Verwenden Sie für OLE DB-unterstützte Datenquellen die mit den DataAdapter zugehörigen OleDbCommand - und OleDbConnection -Objekten. Verwenden Sie für ODBC-unterstützte Datenquellen die mit den DataAdapter zugehörigen OdbcCommand - und OdbcConnection -Objekten. Verwenden Sie für Oracle-Datenbanken die mit den DataAdapter zugehörigen OracleCommand - und OracleConnection -Objekten.
Wenn eine instance von DataAdapter erstellt wird, werden die Lese-/Schreibeigenschaften auf anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im DataAdapter Konstruktor.
Konstruktoren
| DataAdapter() |
Initialisiert eine neue Instanz der DataAdapter-Klasse. |
| DataAdapter(DataAdapter) |
Initialisiert eine neue instance der DataAdapter -Klasse aus einem vorhandenen Objekt desselben Typs. |
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. |
| AcceptChangesDuringUpdate |
Ruft ab oder legt fest, ob AcceptChanges() während eines Update(DataSet) aufgerufen wird. |
| 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. |
| 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) |
| FillLoadOption |
Ruft die LoadOption ab, die bestimmt, wie der Adapter die DataTable vom DbDataReader füllt, oder legt diese fest. |
| MissingMappingAction |
Bestimmt die Aktion, die ausgeführt werden soll, wenn für eingehende Daten keine entsprechende Tabelle oder Spalte vorhanden ist. |
| MissingSchemaAction |
Bestimmt die Aktion, die ausgeführt werden soll, wenn das vorhandene DataSet-Schema eingehenden Daten nicht entspricht. |
| ReturnProviderSpecificTypes |
Ruft ab oder legt fest, ob die |
| 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 DataTablebereitstellt. |
Methoden
| CloneInternals() |
Veraltet.
Veraltet.
Veraltet.
Veraltet.
Erstellt eine Kopie dieser Instanz 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) |
| CreateTableMappings() |
Erstellt einen neuen DataTableMappingCollection. |
| Dispose() |
Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component) |
| Dispose(Boolean) |
Gibt die von DataAdapter 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) |
| Fill(DataSet) |
Fügt dem DataSet Zeilen hinzu oder aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. |
| 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. |
| 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. |
| 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. |
| FillSchema(DataSet, SchemaType) |
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, IDataReader) | |
| FillSchema(DataTable, SchemaType, IDataReader) | |
| 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. |
| 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) |
Wird aufgerufen, wenn während eines |
| ResetFillLoadOption() |
Setzt die FillLoadOption auf ihren Standardzustand zurück und erzwingt, dass Fill(DataSet)AcceptChangesDuringFill berücksichtigt. |
| ShouldSerializeAcceptChangesDuringFill() |
Bestimmt, ob die AcceptChangesDuringFill-Eigenschaft beibehalten werden soll. |
| ShouldSerializeFillLoadOption() |
Bestimmt, ob die FillLoadOption-Eigenschaft beibehalten werden soll. |
| ShouldSerializeTableMappings() |
Bestimmt, ob ein oder mehrere DataTableMapping-Objekte vorhanden sind und ob diese beibehalten werden sollen. |
| 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(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. |
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. |
Explizite Schnittstellenimplementierungen
| IDataAdapter.TableMappings |
Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird. |
