DbDataAdapter DbDataAdapter DbDataAdapter DbDataAdapter Class

Definition

Aids implementation of the IDbDataAdapter interface. Inheritors of DbDataAdapter implement a set of functions to provide strong typing, but inherit most of the functionality needed to fully implement a DataAdapter.

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter
public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter
type DbDataAdapter = class
    inherit DataAdapter
    interface IDbDataAdapter
    interface ICloneable
    interface IDataAdapter
Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter
Inheritance
Derived
Implements

Remarks

The DbDataAdapter class inherits from the DataAdapter class and implements the IDbDataAdapter interface. It helps a class implement a DataAdapter designed for use with a relational database.

An application does not create an instance of the DbDataAdapter class directly, but creates an instance of a class that inherits from it.

Classes that inherit DbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. For example, the DbDataAdapter class defines the SelectCommand property, and the DbDataAdapter class defines eight overloads of the Fill method. In turn, the OleDbDataAdapter class inherits the Fill method, and also defines two additional overloads of Fill that take an ADO Recordset object as a parameter.

Notes to Inheritors

When you inherit from the DbDataAdapter class, we recommend that you implement the following constructors:

Item Description
*Prv*DataAdapter() Initializes a new instance of the *Prv*DataAdapter class.
*Prv*DataAdapter(*Prv*Command *selectCommand*) Initializes a new instance of the *Prv*DataAdapter class with the specified SQL SELECT statement.
*Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a connection string.
*Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) Initializes a new instance of the *Prv*DataAdapter class with an SQL SELECT statement and a *Prv*Connection object.

To promote consistency among .NET Framework data providers, you should name the inheriting class in the form PrvDataAdapter, where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. For example, "Sql" is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Constructors

DbDataAdapter() DbDataAdapter() DbDataAdapter() DbDataAdapter()

Initializes a new instance of a DataAdapter class.

DbDataAdapter(DbDataAdapter) DbDataAdapter(DbDataAdapter) DbDataAdapter(DbDataAdapter) DbDataAdapter(DbDataAdapter)

Initializes a new instance of a DataAdapter class from an existing object of the same type.

Fields

DefaultSourceTableName DefaultSourceTableName DefaultSourceTableName DefaultSourceTableName

The default name used by the DataAdapter object for table mappings.

Properties

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

(Inherited from DataAdapter)
AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate

Gets or sets whether AcceptChanges() is called during a Update(DataSet).

(Inherited from DataAdapter)
CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Gets the IContainer that contains the Component.

(Inherited from Component)
ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError

Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

(Inherited from DataAdapter)
DeleteCommand DeleteCommand DeleteCommand DeleteCommand

Gets or sets a command for deleting records from the data set.

DesignMode DesignMode DesignMode DesignMode

Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FillCommandBehavior FillCommandBehavior FillCommandBehavior FillCommandBehavior

Gets or sets the behavior of the command used to fill the data adapter.

FillLoadOption FillLoadOption FillLoadOption FillLoadOption

Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

(Inherited from DataAdapter)
IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings

Indicates how a source table is mapped to a dataset table.

(Inherited from DataAdapter)
InsertCommand InsertCommand InsertCommand InsertCommand

Gets or sets a command used to insert new records into the data source.

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Determines the action to take when incoming data does not have a matching table or column.

(Inherited from DataAdapter)
MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Determines the action to take when existing DataSet schema does not match incoming data.

(Inherited from DataAdapter)
ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes

Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

(Inherited from DataAdapter)
SelectCommand SelectCommand SelectCommand SelectCommand

Gets or sets a command used to select records in the data source.

Site Site Site Site

Gets or sets the ISite of the Component.

(Inherited from Component)
TableMappings TableMappings TableMappings TableMappings

Gets a collection that provides the master mapping between a source table and a DataTable.

(Inherited from DataAdapter)
UpdateBatchSize UpdateBatchSize UpdateBatchSize UpdateBatchSize

Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

UpdateCommand UpdateCommand UpdateCommand UpdateCommand

Gets or sets a command used to update records in the data source.

Methods

AddToBatch(IDbCommand) AddToBatch(IDbCommand) AddToBatch(IDbCommand) AddToBatch(IDbCommand)

Adds a IDbCommand to the current batch.

ClearBatch() ClearBatch() ClearBatch() ClearBatch()

Removes all IDbCommand objects from the batch.

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

Creates a copy of this instance of DataAdapter.

(Inherited from DataAdapter)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initializes a new instance of the RowUpdatedEventArgs class.

CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

Initializes a new instance of the RowUpdatingEventArgs class.

CreateTableMappings() CreateTableMappings() CreateTableMappings() CreateTableMappings()

Creates a new DataTableMappingCollection.

(Inherited from DataAdapter)
Dispose() Dispose() Dispose() Dispose()

Releases all resources used by the Component.

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

Releases the unmanaged resources used by the DbDataAdapter and optionally releases the managed resources.

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

Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteBatch() ExecuteBatch() ExecuteBatch() ExecuteBatch()

Executes the current batch.

Fill(DataSet) Fill(DataSet) Fill(DataSet) Fill(DataSet)

Adds or refreshes rows in the DataSet.

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

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(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and source table names, command string, and command behavior.

Fill(DataSet, String) Fill(DataSet, String) Fill(DataSet, String) Fill(DataSet, String)

Adds or refreshes rows in the DataSet to match those in the data source using the DataSet and DataTable names.

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

Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataTable name.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)
Fill(DataTable, IDbCommand, CommandBehavior) Fill(DataTable, IDbCommand, CommandBehavior) Fill(DataTable, IDbCommand, CommandBehavior) Fill(DataTable, IDbCommand, CommandBehavior)

Adds or refreshes rows in a DataTable to match those in the data source using the specified DataTable, IDbCommand and CommandBehavior.

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) 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.

(Inherited from DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

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(Int32, Int32, DataTable[]) Fill(Int32, Int32, DataTable[]) Fill(Int32, Int32, DataTable[]) Fill(Int32, Int32, DataTable[])

Adds or refreshes rows in a DataTable to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.

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

Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

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) FillSchema(DataSet, SchemaType, String) FillSchema(DataSet, SchemaType, String) FillSchema(DataSet, SchemaType, String)

Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based upon the specified SchemaType and DataTable.

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

Adds a DataTable to the specified DataSet.

(Inherited from DataAdapter)
FillSchema(DataTable, SchemaType) FillSchema(DataTable, SchemaType) FillSchema(DataTable, SchemaType) FillSchema(DataTable, SchemaType)

Configures the schema of the specified DataTable based on the specified SchemaType.

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

Adds a DataTable to the specified DataSet.

(Inherited from DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

Configures the schema of the specified DataTable based on the specified SchemaType, command string, and CommandBehavior values.

GetBatchedParameter(Int32, Int32) GetBatchedParameter(Int32, Int32) GetBatchedParameter(Int32, Int32) GetBatchedParameter(Int32, Int32)

Returns a IDataParameter from one of the commands in the current batch.

GetBatchedRecordsAffected(Int32, Int32, Exception) GetBatchedRecordsAffected(Int32, Int32, Exception) GetBatchedRecordsAffected(Int32, Int32, Exception) GetBatchedRecordsAffected(Int32, Int32, Exception)

Returns information about an individual update attempt within a larger batched update.

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

Gets the parameters set by the user when executing an SQL SELECT statement.

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

Serves as the default hash function.

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

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)

Returns an object that represents a service provided by the Component or by its Container.

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

Gets the Type of the current instance.

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

Indicates whether a DataTableMappingCollection has been created.

(Inherited from DataAdapter)
InitializeBatching() InitializeBatching() InitializeBatching() InitializeBatching()

Initializes batching for the DbDataAdapter.

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

Obtains a lifetime service object to control the lifetime policy for this instance.

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

Creates a shallow copy of the current Object.

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

Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs)
OnRowUpdated(RowUpdatedEventArgs) OnRowUpdated(RowUpdatedEventArgs) OnRowUpdated(RowUpdatedEventArgs) OnRowUpdated(RowUpdatedEventArgs)

Raises the RowUpdated event of a .NET Framework data provider.

OnRowUpdating(RowUpdatingEventArgs) OnRowUpdating(RowUpdatingEventArgs) OnRowUpdating(RowUpdatingEventArgs) OnRowUpdating(RowUpdatingEventArgs)

Raises the RowUpdating event of a .NET Framework data provider.

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

Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

(Inherited from DataAdapter)
ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill()

Determines whether the AcceptChangesDuringFill property should be persisted.

(Inherited from DataAdapter)
ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption()

Determines whether the FillLoadOption property should be persisted.

(Inherited from DataAdapter)
ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings()

Determines whether one or more DataTableMapping objects exist and they should be persisted.

(Inherited from DataAdapter)
TerminateBatching() TerminateBatching() TerminateBatching() TerminateBatching()

Ends batching for the DbDataAdapter.

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

Returns a String containing the name of the Component, if any. This method should not be overridden.

(Inherited from Component)
Update(DataRow[]) Update(DataRow[]) Update(DataRow[]) Update(DataRow[])

Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the DataSet.

Update(DataRow[], DataTableMapping) Update(DataRow[], DataTableMapping) Update(DataRow[], DataTableMapping) Update(DataRow[], DataTableMapping)

Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of DataSet objects.

Update(DataSet) Update(DataSet) Update(DataSet) Update(DataSet)

Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet.

Update(DataSet, String) Update(DataSet, String) Update(DataSet, String) Update(DataSet, String)

Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the DataSet with the specified DataTable name.

Update(DataTable) Update(DataTable) Update(DataTable) Update(DataTable)

Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataTable.

Events

Disposed Disposed Disposed Disposed

Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FillError FillError FillError FillError

Explicit Interface Implementations

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Creates a new object that is a copy of the current instance.

IDbDataAdapter.DeleteCommand IDbDataAdapter.DeleteCommand IDbDataAdapter.DeleteCommand IDbDataAdapter.DeleteCommand

Gets or sets an SQL statement for deleting records from the data set.

IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand

Gets or sets an SQL statement used to insert new records into the data source.

IDbDataAdapter.SelectCommand IDbDataAdapter.SelectCommand IDbDataAdapter.SelectCommand IDbDataAdapter.SelectCommand

Gets or sets an SQL statement used to select records in the data source.

IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand

Gets or sets an SQL statement used to update records in the data source.

Applies to

See Also