DataAdapter Class
.NET Framework 4
Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DataAdapter
System.Data.Common.DbDataAdapter
Assembly: System.Data (in System.Data.dll)
The DataAdapter type exposes the following members.
| Name | Description | |
|---|---|---|
|
DataAdapter() | Initializes a new instance of a DataAdapter class. |
|
|
DataAdapter(DataAdapter) | Initializes a new instance of a DataAdapter class from an existing object of the same type. |
| Name | Description | |
|---|---|---|
|
AcceptChangesDuringFill | 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 | Gets or sets whether AcceptChanges is called during a Update. |
|
CanRaiseEvents | Gets a value indicating whether the component can raise an event. (Inherited from Component.) |
|
|
Container | Gets the IContainer that contains the Component. (Inherited from Component.) |
|
|
ContinueUpdateOnError | Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update. |
|
|
DesignMode | Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.) |
|
|
Events | Gets the list of event handlers that are attached to this Component. (Inherited from Component.) |
|
|
FillLoadOption | Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader. |
|
|
MissingMappingAction | Determines the action to take when incoming data does not have a matching table or column. |
|
|
MissingSchemaAction | Determines the action to take when existing DataSet schema does not match incoming data. |
|
|
ReturnProviderSpecificTypes | Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values. |
|
|
Site | Gets or sets the ISite of the Component. (Inherited from Component.) |
|
|
TableMappings | Gets a collection that provides the master mapping between a source table and a DataTable. |
| Name | Description | |
|---|---|---|
|
|
CloneInternals | Obsolete. Creates a copy of this instance of DataAdapter. |
|
CreateObjRef | 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 | Creates a new DataTableMappingCollection. |
|
|
Dispose() | Releases all resources used by the Component. (Inherited from Component.) |
|
|
Dispose(Boolean) | Releases the unmanaged resources used by the DataAdapter and optionally releases the managed resources. (Overrides Component.Dispose(Boolean).) |
|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
|
Fill(DataSet) | Adds or refreshes rows in the DataSet to match those in the data source. |
|
|
Fill(DataTable, 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) | Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source. |
|
|
Fill(DataSet, String, IDataReader, Int32, Int32) | Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names. |
|
|
FillSchema(DataSet, 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(DataTable, SchemaType, IDataReader) | Adds a DataTable to the specified DataSet. |
|
|
FillSchema(DataSet, SchemaType, String, IDataReader) | Adds a DataTable to the specified DataSet. |
|
|
Finalize | Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.) |
|
|
GetFillParameters | Gets the parameters set by the user when executing an SQL SELECT statement. |
|
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
|
GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
|
|
GetService | Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.) |
|
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
|
HasTableMappings | Indicates whether a DataTableMappingCollection has been created. |
|
|
InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
|
|
MemberwiseClone() | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
|
MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
|
|
OnFillError | Invoked when an error occurs during a Fill. |
|
|
ResetFillLoadOption | Resets FillLoadOption to its default state and causes DataAdapter.Fill to honor AcceptChangesDuringFill. |
|
|
ShouldSerializeAcceptChangesDuringFill | Determines whether the AcceptChangesDuringFill property should be persisted. |
|
|
ShouldSerializeFillLoadOption | Determines whether the FillLoadOption property should be persisted. |
|
|
ShouldSerializeTableMappings | Determines whether one or more DataTableMapping objects exist and they should be persisted. |
|
|
ToString |
Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.) In XNA Framework 3.0, this member is inherited from Object.ToString(). |
|
|
Update | Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table." |
| Name | Description | |
|---|---|---|
|
IDataAdapter.TableMappings | Indicates how a source table is mapped to a dataset table. |
The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. 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.
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. For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.
When an instance of DataAdapter is created, the read/write properties are set to initial values. For a list of these values, see the DataAdapter constructor.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
