DataAdapter Klasse

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

Der DataAdapter dient als Brücke zwischen einem 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. Der DataAdapter stellt diese Brücke bereit, indem er Fillzuordnet, die die Daten in der DataSet so ändert, dass Sie mit den Daten in der Datenquelle verglichen werden, und Update, der die Daten in der Datenquelle ändert, sodass Sie mit den Daten in der DataSetidentisch ist.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 eine Verbindung mit einer SQL Server Datenbank herstellen, können Sie die Gesamtleistung erhöhen, indem Sie die SqlDataAdapter zusammen mit den zugehörigen SqlCommand und SqlConnection Objekten verwenden.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ützte Datenquellen die DataAdapter mit den zugehörigen OleDbCommand und OleDbConnection Objekten.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Verwenden Sie für ODBC-unterstützte Datenquellen die DataAdapter mit den zugehörigen OdbcCommand und OdbcConnection Objekten.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Verwenden Sie für Oracle-Datenbanken die DataAdapter mit den zugehörigen OracleCommand und OracleConnection Objekten.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Wenn eine Instanz von DataAdapter erstellt wird, werden die Lese-/Schreibeigenschaften auf anfängliche Werte festgelegt.When an instance of DataAdapter is created, the read/write properties are set to initial values. Eine Liste dieser Werte finden Sie im DataAdapter-Konstruktor.For a list of these values, see the DataAdapter constructor.

Konstruktoren

DataAdapter()

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

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

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

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

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.

(Geerbt von Component)
Container

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

(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.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

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.

(Geerbt von Component)
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.

(Geerbt von Component)
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

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

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

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

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

(Geerbt von Component)
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()

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

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.

(Geerbt von MarshalByRefObject)
CreateTableMappings()

Erstellt einen neuen DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose()

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

(Geerbt von Component)
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)

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

(Geerbt von Object)
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)

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)

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)

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)

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)

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

FillSchema(DataTable, SchemaType, IDataReader)

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

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
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.

(Geerbt von MarshalByRefObject)
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.

(Geerbt von Component)
GetType()

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

(Geerbt von Object)
HasTableMappings()

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

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.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

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

(Geerbt von Object)
MemberwiseClone(Boolean)

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

(Geerbt von MarshalByRefObject)
OnFillError(FillErrorEventArgs)

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

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

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

ShouldSerializeFillLoadOption()

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

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

Gibt einen String zurück, der 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.

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

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.

(Geerbt von Component)
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

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