UpdateCommand Property (DB2DataAdapter)

In This Topic

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

Syntax

Visual Basic
C#

'Declaration
 
Public Shadows Property UpdateCommand As DB2Command

public new DB2Command UpdateCommand {get; set;}

Property Value

A DB2Command used during an update operation to update records in the data source that correspond to modified rows in the System.Data.DataSet.

Remarks

During an update operation, if UpdateCommand is not set and primary key information is present in the System.Data.DataSet, you can use the DB2CommandBuilder class to automatically generate UpdateCommand, and additional commands needed to reconcile the System.Data.DataSet to the data source. To do this, set the SelectCommand property of the DB2DataAdapter. For more information see "Automatically Generated Commands" in the Microsoft .NET Framework SDK documentation.

Note: If execution of this command returns rows, these rows may be merged with the System.Data.DataSet depending upon how you set the Devart.Common.DbCommandBase.UpdatedRowSource property of the DB2Command object.

Example

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

csharp

public void UseDataAdapter(DB2Connection db2Connection)
{
  DB2DataAdapter myAdapter = new DB2DataAdapter("SELECT DeptNo, DName FROM Dept", db2Connection);
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
  DataSet myDataSet = new DataSet();
  myAdapter.Fill(myDataSet,"Departments");
  myDataSet.Tables["Departments"].Rows[3]["DName"] = "Researches";
  myAdapter.UpdateCommand = new DB2Command("UPDATE Dept SET DeptNo = :DeptNo, DName = :DName " +
      "WHERE DeptNo = :oldDeptNo", db2Connection);
  myAdapter.UpdateCommand.Parameters.Add("DeptNo", DB2Type.Int, 0, "DeptNo");
  myAdapter.UpdateCommand.Parameters.Add("DName", DB2Type.VarChar, 15, "DName");
  myAdapter.UpdateCommand.Parameters.Add("oldDeptNo", DB2Type.Int, 0, "DeptNo").SourceVersion = DataRowVersion.Original;
  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 db2Connection As DB2Connection)
  Dim myAdapter As DB2DataAdapter = New DB2DataAdapter("SELECT DeptNo, DName FROM Dept", db2Connection)
  myAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
  Dim myDataSet As DataSet = New DataSet
  myAdapter.Fill(myDataSet, "Departments")
  myDataSet.Tables("Departments").Rows(3)("DName") = "Researches"
  myAdapter.UpdateCommand = New DB2Command("UPDATE Dept SET DeptNo = :DeptNo, DName = :DName " & _
        "WHERE DeptNo = :oldDeptNo", db2Connection)
  myAdapter.UpdateCommand.Parameters.Add("DeptNo", DB2Type.Int, 0, "DeptNo")
  myAdapter.UpdateCommand.Parameters.Add("DName", DB2Type.VarChar, 15, "DName")
  myAdapter.UpdateCommand.Parameters.Add("oldDeptNo", DB2Type.Int, 0, "DeptNo").SourceVersion = DataRowVersion.Original
  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

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

Reference

DB2DataAdapter Class
DB2DataAdapter Members
DeleteCommand Property
InsertCommand Property
SelectCommand Property

Send Feedback