DataAdapter Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.dll

Stellt eine Reihe von SQL-Befehlen und eine Datenbankverbindung dar, die zum Ausfüllen und Aktualisieren der DataSet Datenquelle verwendet wird.

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

Dies DataAdapter dient als Brücke zwischen einer DataSet und einer Datenquelle zum Abrufen und Speichern von Daten. Dies DataAdapter bietet diese Brücke durch Zuordnung Fill, die die Daten in der DataSet Datenquelle ändert, um die Daten in der Datenquelle zuzuordnen, und Update, wodurch die Daten in der Datenquelle entsprechend den Daten in der DataSetDatenquelle geändert werden.

Wenn Sie eine Verbindung mit einer SQL Server-Datenbank herstellen, können Sie die Gesamtleistung erhöhen, indem Sie die SqlDataAdapter zusammen mit den zugeordneten SqlCommand- und SqlConnection-Objekten verwenden. Verwenden Sie für OLE DB-unterstützte Datenquellen die DataAdapter zugehörigen OleDbCommand und OleDbConnection Objekte. Verwenden Sie für ODBC-unterstützte Datenquellen die DataAdapter zugeordneten OdbcCommand und OdbcConnection Objekte. Verwenden Sie für Oracle-Datenbanken die DataAdapter zugehörigen OracleCommand Und OracleConnection Objekte.

Wenn eine Instanz erstellt DataAdapter wird, werden die Lese-/Schreibeigenschaften auf anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im DataAdapter Konstruktor.

Konstruktoren

Name	Beschreibung
DataAdapter()	Initialisiert eine neue Instanz der DataAdapter-Klasse.
DataAdapter(DataAdapter)	Initialisiert eine neue Instanz der DataAdapter Klasse aus einem vorhandenen Objekt desselben Typs.

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.
AcceptChangesDuringUpdate	Ruft ab oder legt fest, ob AcceptChanges() während einer Update(DataSet).
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.
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)
FillLoadOption	Dient zum Abrufen oder Festlegen der LoadOption , die bestimmt, wie der Adapter die DataTable aus dem DbDataReader.
MissingMappingAction	Bestimmt die Aktion, die ausgeführt werden soll, wenn eingehende Daten keine übereinstimmende Tabelle oder Spalte aufweisen.
MissingSchemaAction	Bestimmt die auszuführende Aktion, wenn das vorhandene DataSet Schema nicht mit eingehenden Daten übereinstimmt.
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 DataTable.

Methoden

Name	Beschreibung
CloneInternals()	Veraltet. Erstellt eine Kopie dieser Instanz 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)
CreateTableMappings()	Erstellt ein neues DataTableMappingCollection.
Dispose()	Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den DataAdapter verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
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 DataSet den DataTable Zeilen in der Datenquelle übereinzustimmen.
Fill(DataSet)	Fügt Zeilen in der DataSet Datenquelle hinzu oder aktualisiert sie, um den Zeilen in der Datenquelle zu entsprechen.
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.
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.
FillSchema(DataSet, SchemaType, String, IDataReader)	Fügt dem angegebenen DataTableWert einen DataSet hinzu.
FillSchema(DataSet, SchemaType)	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 entsprichtDataSet.SchemaType
FillSchema(DataTable, SchemaType, IDataReader)	Fügt dem angegebenen DataTableWert einen DataSet hinzu.
GetFillParameters()	Ruft die vom Benutzer beim Ausführen einer SQL SELECT-Anweisung festgelegten Parameter ab.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	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.
InitializeLifetimeService()	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)	Wird aufgerufen, wenn während eines Fehlers Fillein Fehler auftritt.
ResetFillLoadOption()	FillLoadOption Setzt auf seinen Standardzustand zurück und bewirktFill(DataSet), dass er berücksichtigt AcceptChangesDuringFillwird.
ShouldSerializeAcceptChangesDuringFill()	Bestimmt, ob die AcceptChangesDuringFill Eigenschaft beibehalten werden soll.
ShouldSerializeFillLoadOption()	Bestimmt, ob die FillLoadOption Eigenschaft beibehalten werden soll.
ShouldSerializeTableMappings()	Bestimmt, ob mindestens ein DataTableMapping Objekt vorhanden ist und diese beibehalten werden sollen.
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(DataSet)	Ruft die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen DataSet aus einer DataTable benannten "Tabelle" auf.

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.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataAdapter.TableMappings	Ruft eine Auflistung ab, die angibt, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.

Weitere Informationen

• Übersicht über ADO.NET