Export (0) Print
Expand All

IDbDataAdapter Interface

Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET Framework data providers that access relational databases.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)

type IDbDataAdapter =  
    interface 
        interface IDataAdapter 
    end

The IDbDataAdapter type exposes the following members.

  NameDescription
Public propertySupported by the XNA FrameworkDeleteCommandGets or sets an SQL statement for deleting records from the data set.
Public propertySupported by the XNA FrameworkInsertCommandGets or sets an SQL statement used to insert new records into the data source.
Public propertySupported by the XNA FrameworkMissingMappingActionIndicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error. (Inherited from IDataAdapter.)
Public propertySupported by the XNA FrameworkMissingSchemaActionIndicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised. (Inherited from IDataAdapter.)
Public propertySupported by the XNA FrameworkSelectCommandGets or sets an SQL statement used to select records in the data source.
Public propertySupported by the XNA FrameworkTableMappingsIndicates how a source table is mapped to a dataset table. (Inherited from IDataAdapter.)
Public propertySupported by the XNA FrameworkUpdateCommandGets or sets an SQL statement used to update records in the data source.
Top

  NameDescription
Public methodSupported by the XNA FrameworkFillAdds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "Table". (Inherited from IDataAdapter.)
Public methodSupported by the XNA FrameworkFillSchemaAdds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType. (Inherited from IDataAdapter.)
Public methodSupported by the XNA FrameworkGetFillParametersGets the parameters set by the user when executing an SQL SELECT statement. (Inherited from IDataAdapter.)
Public methodSupported by the XNA FrameworkUpdateCalls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table". (Inherited from IDataAdapter.)
Top

The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter. For more information about implementing .NET Framework data providers, see [<topic://cpconimplementingnetdataprovider>].

An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

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

Notes to Implementers

To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter 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.

When you inherit from the IDbDataAdapter interface, you should implement the following constructors:

Item

Description

PrvDataAdapter()

Initializes a new instance of the PrvDataAdapter class.

PrvDataAdapter(PrvCommand selectCommand)

Initializes a new instance of the PrvDataAdapter class with the specified SQL SELECT statement.

PrvDataAdapter(string selectCommandText, string selectConnectionString)

Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a connection string.

PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)

Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a PrvConnection object.

The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. The filled DataSet is then returned. To accomplish this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft