SqlDataAdapter Class

In This Topic

Represents a set of data commands and a data source connection that are used to fill the System.Data.DataSet and update a SQL Server data.

Syntax

Visual Basic
C#

'Declaration
 
Public Class SqlDataAdapter 
   Inherits Devart.Common.DbDataAdapter
   Implements System.ComponentModel.IComponent, System.Data.IDataAdapter, System.Data.IDbDataAdapter, System.ICloneable, System.IDisposable

public class SqlDataAdapter : Devart.Common.DbDataAdapter, System.ComponentModel.IComponent, System.Data.IDataAdapter, System.Data.IDbDataAdapter, System.ICloneable, System.IDisposable

Remarks

The SqlDataAdapter serves as a bridge between a System.Data.DataSet and a data source for retrieving and saving data. The SqlDataAdapter provides this bridge by using System.Data.Common.DbDataAdapter.Fill to load data from the data source into the System.Data.DataSet, and using System.Data.DataSet.Update() to send changes made in the System.Data.DataSet back to the data source.

SqlDataAdapter is used in conjunction with SqlConnection and SqlCommand to increase performance when connecting to SQL Server.

The SqlDataAdapter also includes the SelectCommand, InsertCommand, DeleteCommand, UpdateCommand, and Devart.Data.SqlShimDataAdapter.TableMappings properties to facilitate loading and updating of data.

Example

The following example demonstrates how to retrieve and manipulate data using SqlDataAdapter.

csharp

public void UseDataAdapter(SqlConnection myConnection)
{
  SqlDataAdapter myAdapter = new SqlDataAdapter("SELECT DeptNo, DName FROM Test.Dept", myConnection);
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
  DataSet myDataSet = new DataSet();
  myAdapter.Fill(myDataSet,"Departments");
  object[] rowVals = new object[2];
  rowVals[0] = 40;
  rowVals[1] = "Operations";
  myDataSet.Tables["Departments"].Rows.Add(rowVals);
  myAdapter.InsertCommand = new SqlCommand("INSERT INTO Test.Dept (DeptNo, DName) " +
    "VALUES (:DeptNo, :DName)", myConnection);
  myAdapter.InsertCommand.Parameters.Add("DeptNo", SqlType.Int, 0, "DeptNo");
  myAdapter.InsertCommand.Parameters.Add("DName", SqlType.VarChar, 15, "DName");
  myAdapter.Update(myDataSet,"Departments"); 
  //Get all data from all tables within the dataset
  foreach(DataTable myTable in myDataSet.Tables)
  {
    foreach(DataRow myRow in myTable.Rows)
    {
      foreach (DataColumn myColumn in myTable.Columns)
      {
        Console.Write(myRow[myColumn]+"\t");
      }
      Console.WriteLine();
    }
    Console.WriteLine();
  }
}

Visual Basic

Public Sub UseDataAdapter(ByVal myConnection As SqlConnection)
  Dim myAdapter As SqlDataAdapter = New SqlDataAdapter("SELECT DeptNo, DName FROM Test.Dept", myConnection)
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
  Dim myDataSet As DataSet = New DataSet
  myAdapter.Fill(myDataSet, "Departments")
  Dim rowVals(1) As Object
  rowVals(0) = "40"
  rowVals(1) = "Operations"
  myDataSet.Tables("Departments").Rows.Add(rowVals)
  myAdapter.InsertCommand = New SqlCommand("INSERT INTO Test.Dept (DeptNo, DName) " & _
      "VALUES (:DeptNo, :DName)", myConnection)
  myAdapter.InsertCommand.Parameters.Add("DeptNo", SqlType.Int, 0, "DeptNo")
  myAdapter.InsertCommand.Parameters.Add("DName", SqlType.VarChar, 15, "DName")
  myAdapter.Update(myDataSet, "Departments")
  Dim myTable As DataTable
  Dim myRow As DataRow
  Dim myColumn As DataColumn
  ' Get all data from all tables within the dataset
  For Each myTable In myDataSet.Tables
    For Each myRow In myTable.Rows
      For Each myColumn In myTable.Columns
        Console.Write(myRow(myColumn) & Chr(9))
      Next myColumn
      Console.WriteLine()
    Next myRow
    Console.WriteLine()
  Next myTable
End Sub

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Data.Common.DataAdapter
            System.Data.Common.DbDataAdapter
               Devart.Common.DbDataAdapter
                  Devart.Data.SqlServer.SqlDataAdapter

Reference

SqlDataAdapter Members
Devart.Data.SqlServer Namespace
SqlConnection Class
SqlCommand Class

Send Feedback