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 einer 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 fest, ob AcceptChanges() während eines Update(DataSet) aufgerufen wird.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 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.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 die LoadOption ab, die bestimmt, wie der Adapter die DataTable vom DbDataReader füllt, oder legt diese fest.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Bestimmt die Aktion, die ausgeführt werden soll, wenn für eingehende Daten keine entsprechende Tabelle oder Spalte vorhanden ist.Determines the action to take when incoming data does not have a matching table or column.

MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Bestimmt die Aktion, die ausgeführt werden soll, wenn das vorhandene DataSet-Schema eingehenden 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 fest, ob die Fill-Methode anbieterspezifische Werte oder allgemeine CLS-kompatible Werte zurückgeben soll.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
TableMappings TableMappings TableMappings TableMappings

Ruft eine Auflistung ab, die die Masterzuordnung zwischen einer Quelltabelle und einer DataTable bereitstellt.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 dem DataSet Zeilen hinzu oder aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen.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)

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.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 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.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)

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.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 dem angegebenen DataTable eine DataSet mit dem Namen "Table" hinzu und konfiguriert das Schema anhand des angegebenen SchemaType so, dass es dem Schema in der Datenquelle entspricht.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 dem angegebenen DataTable eine DataSet hinzu.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 dem angegebenen DataTable eine DataSet hinzu.Adds a DataTable to the specified DataSet.

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

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

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

Fungiert als die 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 während eines Fill ein Fehler auftritt.Invoked when an error occurs during a Fill.

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

Setzt die FillLoadOption auf ihren Standardzustand zurück und erzwingt, dass Fill(DataSet)AcceptChangesDuringFill berücksichtigt.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 ob diese beibehalten werden sollen.Determines whether one or more DataTableMapping objects exist and they should be persisted.

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

Gibt eine String zurück, die den Namen der 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 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.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

Wird zurückgegeben, wenn während eines Füllvorgangs ein Fehler 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