dotConnect Universal Documentation
Devart.Data.Universal Namespace / UniDataAdapter Class
Members Example

In This Topic
    UniDataAdapter Class
    In This Topic
    Represents a set of data commands and a database connection that are used to fill the System.Data.DataSet and update a database.
    Syntax
    Remarks
    The UniDataAdapter serves as a bridge between a System.Data.DataSet and database for retrieving and saving data. The UniDataAdapter provides this bridge by using System.Data.Common.DbDataAdapter.Fill to load data from the database into the System.Data.DataSet, and using System.Data.DataSet.Update() to send changes made in the System.Data.DataSet back to the database.

    UniDataAdapter is used in conjunction with UniConnection and UniCommand to increase performance when connecting to a server.

    The UniDataAdapter also includes the SelectCommand, InsertCommand, DeleteCommand, UpdateCommand, and TableMappings properties to facilitate loading and updating of data.

    Example
    The following example demonstrates how to retrieve and manipulate data using UniDataAdapter.
    public void UseDataAdapter(UniConnection myConnection)
    {
      UniDataAdapter myAdapter = new UniDataAdapter("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 UniCommand("INSERT INTO Test.Dept (DeptNo, DName) " +
        "VALUES (:DeptNo, :DName)", myConnection);
      myAdapter.InsertCommand.Parameters.Add("DeptNo", UniDbType.Int, 0, "DeptNo");
      myAdapter.InsertCommand.Parameters.Add("DName", UniDbType.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();
      }
    }
    Public Sub UseDataAdapter(ByVal myConnection As UniConnection)
      Dim myAdapter As UniDataAdapter = New UniDataAdapter("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 UniCommand("INSERT INTO Test.Dept (DeptNo, DName) " & _
          "VALUES (:DeptNo, :DName)", myConnection)
      myAdapter.InsertCommand.Parameters.Add("DeptNo", UniDbType.Int, 0, "DeptNo")
      myAdapter.InsertCommand.Parameters.Add("DName", UniDbType.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.Universal.UniDataAdapter

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also