UpdateCommand Property (SqlDataTable)

In This Topic

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

Syntax

Visual Basic
C#

'Declaration
 
Public Shadows Property UpdateCommand As SqlCommand

public new SqlCommand UpdateCommand {get; set;}

Property Value

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

Remarks

UpdateCommand uses its own Connection if it is created. Otherwise UpdateCommand uses Connection.

Example

This sample shows how to modify and display data using SqlDataTable.

csharp

public void UseDataTable(SqlConnection myConnection)
{
  SqlDataTable myDataTable = new SqlDataTable("SELECT * FROM Test.Dept", myConnection);
  try
  {
    myDataTable.Active = true;
    myDataTable.Rows[3]["DName"] = "Researches";
    myDataTable.UpdateCommand = new SqlCommand("UPDATE Test.Dept SET DeptNo = :DeptNo, DName = :DName, Loc = 'Modified' " +
        "WHERE DeptNo = :oldDeptNo", myConnection);
    myDataTable.UpdateCommand.Parameters.Add("DeptNo", SqlType.Int, 0, "DeptNo");
    myDataTable.UpdateCommand.Parameters.Add("DName", SqlType.VarChar, 15, "DName");
    myDataTable.UpdateCommand.Parameters.Add("oldDeptNo", SqlType.Int, 0, "DeptNo").SourceVersion = DataRowVersion.Original;
    Console.WriteLine(myDataTable.Update()+" rows updated.");
    myDataTable.Active = false;
    //Refresh the table to check custom updates
    myDataTable.Active = true;                  
    foreach(DataRow myRow in myDataTable.Rows)
    {
      foreach(DataColumn myCol in myDataTable.Columns)
      {
        Console.Write(myRow[myCol]+"\t");
      }
      Console.WriteLine();
    }
  }
  finally
  {
    myDataTable.Active = false;
  }
}

Visual Basic

Public Sub UseDataTable(ByVal myConnection As SqlConnection)
  Dim myDataTable As SqlDataTable = New SqlDataTable("SELECT * FROM Test.Dept", myConnection)
  Try
    myDataTable.Active = True
    myDataTable.Rows(3)("DName") = "Researches"
    myDataTable.UpdateCommand = New SqlCommand("UPDATE Test.Dept SET DeptNo = :DeptNo, DName = :DName, Loc='Modified' " & _
        "WHERE DeptNo = :oldDeptNo", myConnection)
    myDataTable.UpdateCommand.Parameters.Add("DeptNo", SqlType.Int, 0, "DeptNo")
    myDataTable.UpdateCommand.Parameters.Add("DName", SqlType.VarChar, 15, "DName")
    myDataTable.UpdateCommand.Parameters.Add("oldDeptNo", SqlType.Int, 0, "DeptNo").SourceVersion = DataRowVersion.Original
    Console.WriteLine(myDataTable.Update() & " rows updated.")
    myDataTable.Active = False
    ' Refresh the table to check custom updates
    myDataTable.Active = True
    Dim myRow As DataRow
    Dim myCol As DataColumn
    For Each myRow In myDataTable.Rows
      For Each myCol In myDataTable.Columns
        Console.Write(myRow(myCol) & Chr(9))
      Next myCol
      Console.WriteLine()
    Next myRow
  Finally
    myDataTable.Active = False
  End Try
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

SqlDataTable Class
SqlDataTable Members
DeleteCommand Property
InsertCommand Property
SelectCommand Property

Send Feedback