System.Data Namespace
Represents the base set of command-related properties that are used to fill a DataSet and update a data source, and is implemented by .NET data providers that access relational databases.
| Class |
Description |
| OleDbDataAdapter |
Represents a set of data commands and a database connection which are used to fill the DataSet and update the data source. |
| SqlDataAdapter |
Represents a set of data commands and a database connection which are used to fill the DataSet and update an SQL Server™ database. This class cannot be inherited. |
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 data providers, see Implementing a .NET Data Provider.
An application does not create an instance of the IDbDataAdapter interface directly, but initializes 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 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 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.
public DataSet SelectSqlSrvRows ( DataSet dataset,
string connection,string query ) {
SqlConnection conn = new SqlConnection ( connection );
SqlDataAdapter adapter = new SqlDataAdapter ( );
adapter.SelectCommand = new SqlCommand ( query, conn );
adapter.Fill ( dataset );
return dataset;
}
Public Function SelectSqlSrvRows ( dataset As DataSet, _
connection As String, query As String ) As DataSet
Dim conn As New SqlConnection ( connection )
Dim adapter As New SqlDataAdapter ( )
adapter.SelectCommand = new SqlCommand ( query, conn )
adapter.Fill ( dataset )
Return dataset
End Function |
| |
C# |
VB |
