DataAdapter Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DataAdapter.cs

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::IDataAdapter

public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

Vererbung

Object

MarshalByRefObject

Component

DataAdapter

Abgeleitet

System.Data.Common.DbDataAdapter

Implementiert

IDataAdapter

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 Fill-Methode anbieterspezifische Werte oder allgemeine CLS-kompatible Werte zurückgeben soll.
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. 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)	Fügt dem angegebenen DataTable eine DataSet hinzu.
FillSchema(DataTable, SchemaType, IDataReader)	Fügt dem angegebenen DataTable eine DataSet hinzu.
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 Fill ein Fehler auftritt.
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.

Weitere Informationen

• Übersicht über ADO.NET