DataAdapter DataAdapter DataAdapter DataAdapter Class

Definition

Stellt einen Satz von SQL-Befehlen und eine Datenbankverbindung dar, die verwendet werden, um das DataSet aufzufüllen und die Datenquelle zu aktualisieren.Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

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
Abgeleitet
Implementiert

Hinweise

Die DataAdapter dient als Brücke zwischen einer DataSet und einer Datenquelle zum Abrufen und Speichern von Daten.The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. Die DataAdapter stellt diese Brücke bereit, durch die Zuordnung Fill, geändert wird, die die Daten in die DataSet zum Abgleich der Daten in der Datenquelle und Update, geändert wird, die die Daten in der Datenquelle entsprechend die Daten in die DataSet.The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

Wenn Sie mit einer SQL Server-Datenbank herstellen, können Sie die allgemeine Leistung steigern, mithilfe der SqlDataAdapter zusammen mit der zugehörigen SqlCommand und SqlConnection Objekte.If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. Verwenden Sie für OLE DB-Unterstützung für Datenquellen, die DataAdapter mit der entsprechenden OleDbCommand und OleDbConnection Objekte.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Verwenden Sie für ODBC-Unterstützung für Datenquellen, die DataAdapter mit der entsprechenden OdbcCommand und OdbcConnection Objekte.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Verwenden Sie für Oracle-Datenbanken, die DataAdapter mit der entsprechenden OracleCommand und OracleConnection Objekte.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Wenn eine Instanz des DataAdapter wird erstellt, die Lese-/Schreibzugriff Eigenschaften auf die ursprünglichen Werte festgelegt werden.When an instance of DataAdapter is created, the read/write properties are set to initial values. Eine Liste dieser Werte finden Sie in der DataAdapter Konstruktor.For a list of these values, see the DataAdapter constructor.

Konstruktoren

DataAdapter() DataAdapter() DataAdapter() DataAdapter()

Initialisiert eine neue Instanz einer DataAdapter-Klasse.Initializes a new instance of a DataAdapter class.

DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter)

Initialisiert eine neue Instanz von einem DataAdapter Klasse aus einem vorhandenen Objekt desselben Typs.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Eigenschaften

AcceptChangesDuringFill AcceptChangesDuringFill AcceptChangesDuringFill 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.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate

Ruft ab oder legt ihn fest, ob AcceptChanges() wird aufgerufen, während eine Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError

Ruft ab oder legt einen Wert, der angibt, ob eine Ausnahme aus, wenn ein Fehler generiert, die während der Aktualisierung einer Zeile erkannt wird.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FillLoadOption FillLoadOption FillLoadOption FillLoadOption

Ruft ab oder legt diesen fest der LoadOption , der bestimmt, wie der Adapter füllt die DataTable aus der DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Bestimmt die Aktion an, die bei der eingehende Daten nicht über eine entsprechende Tabelle oder Spalte verfügt.Determines the action to take when incoming data does not have a matching table or column.

MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Bestimmt die Aktion an, wenn das vorhandene DataSet -Schema eingehende Daten nicht entspricht.Determines the action to take when existing DataSet schema does not match incoming data.

ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes

Ruft ab oder legt ihn fest, ob die Fill Methode sollte anbieterspezifische Werte oder allgemeine CLS-kompatible Werte zurückgeben.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

Site Site Site Site

Ruft die ISite der Component ab oder legt diese fest.Gets or sets the ISite of the Component.

(Inherited from Component)
TableMappings TableMappings TableMappings TableMappings

Ruft eine Auflistung, die die masterzuordnung zwischen einer Quelltabelle bereitstellt und eine DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

Methoden

CloneInternals() CloneInternals() CloneInternals() CloneInternals()

Erstellt eine Kopie dieser Instanz von DataAdapter.Creates a copy of this instance of DataAdapter.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateTableMappings() CreateTableMappings() CreateTableMappings() CreateTableMappings()

Erstellt einen neuen DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von DataAdapter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DataAdapter and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fill(DataSet) Fill(DataSet) Fill(DataSet) Fill(DataSet)

Fügt hinzu oder aktualisiert Zeilen in der DataSet mit denen in der Datenquelle übereinstimmen.Adds or refreshes rows in the DataSet to match those in the data source.

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

Fügt hinzu oder aktualisiert Zeilen in einem angegebenen Bereich in der DataSet entsprechend in der Datenquelle mithilfe der DataSet und DataTable Namen.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Fügt hinzu oder aktualisiert Zeilen in der DataTable entsprechend in der Datenquelle mithilfe der DataTable -Namens und des angegebenen IDataReader.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

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

Fügt hinzu oder aktualisiert Zeilen in einem angegebenen Bereich in der Auflistung der DataTable Objekte, mit denen in der Datenquelle übereinstimmen.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType)

Fügt eine DataTable mit dem angegebenen DataSet und konfiguriert das Schema übereinstimmen, die in der Datenquelle auf der Grundlage der angegebenen SchemaType.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader)

Fügt eine DataTable mit dem angegebenen DataSet.Adds a DataTable to the specified DataSet.

FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader)

Fügt eine DataTable mit dem angegebenen DataSet.Adds a DataTable to the specified DataSet.

GetFillParameters() GetFillParameters() GetFillParameters() GetFillParameters()

Ruft die Parameter, die vom Benutzer festgelegt wird, beim Ausführen einer SQL SELECT-Anweisung ab.Gets the parameters set by the user when executing an SQL SELECT statement.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HasTableMappings() HasTableMappings() HasTableMappings() HasTableMappings()

Gibt an, ob eine DataTableMappingCollection erstellt wurde.Indicates whether a DataTableMappingCollection has been created.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs)

Wird aufgerufen, wenn ein Fehler, während auftritt eine Fill.Invoked when an error occurs during a Fill.

ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption()

Setzt FillLoadOption auf seine Standardeinstellungen und bewirkt, dass Fill(DataSet) berücksichtigt AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill()

Bestimmt, ob die AcceptChangesDuringFill -Eigenschaft beibehalten werden soll.Determines whether the AcceptChangesDuringFill property should be persisted.

ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption()

Bestimmt, ob die FillLoadOption -Eigenschaft beibehalten werden soll.Determines whether the FillLoadOption property should be persisted.

ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings()

Bestimmt, ob ein oder mehrere DataTableMapping Objekte vorhanden sind, und diese beibehalten werden sollen.Determines whether one or more DataTableMapping objects exist and they should be persisted.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen dieser Component enthält, sofern vorhanden.Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)
Update(DataSet) Update(DataSet) Update(DataSet) Update(DataSet)

Ruft die entsprechenden INSERT-, Update- oder DELETE-Anweisungen aus, für jede eingefügt, aktualisiert oder Zeile in der angegebenen gelöschte DataSet aus einem DataTable mit dem Namen "Table".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table."

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FillError FillError FillError FillError

Zurückgegeben, wenn ein Fehler bei einem Auffüllvorgang auftritt.Returned when an error occurs during a fill operation.

Explizite Schnittstellenimplementierungen

IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings

Gibt an, wie eine Quelltabelle einer Datasettabelle zugeordnet wird.Indicates how a source table is mapped to a dataset table.

Gilt für:

Siehe auch