ADO.NET Provider for FreshBooks

Build 20.0.7587

Updating the Data

Use the adapter's Update method to update the data. This overloaded method can take a DataTable as a parameter and will commit all the changes made to the data source. The name of the data table can be passed as an argument and can also be used to update the entire dataset in a more traditional manner. When using a data table as an argument to the Update method, the adapter evaluates the changes that have been made to the data table and executes the appropriate command for each row (INSERT, UPDATE, or DELETE).

The example below updates the Username of one of the Clients entries.

C#

using (FreshBooksConnection connection = new FreshBooksConnection(connectionString)) {
  FreshBooksDataAdapter dataAdapter = new FreshBooksDataAdapter(
    "SELECT Email, Username FROM Clients", connection);

  dataAdapter.UpdateCommand = new FreshBooksCommand(
    "UPDATE Clients SET Username = @Username " +
    "WHERE Id = @Id", connection);
 
  dataAdapter.UpdateCommand.Parameters.Add(new FreshBooksParameter("@Username", DbType.String, "Username"));
  dataAdapter.UpdateCommand.Parameters.Add(new FreshBooksParameter("@Id", DbType.String, "Id"));
  dataAdapter.UpdateCommand.Parameters[1].SourceVersion = DataRowVersion.Original;

  DataTable table = new DataTable();
  dataAdapter.Fill(table);

  DataRow firstrow = table.Rows[0];
  firstrow["Username"] = "Jon Doe";

  dataAdapter.Update(table);

  Console.WriteLine("Rows after update.");
  
  foreach (DataRow row in table.Rows) {
    Console.WriteLine("{0}: {1}", row["Email"], row["Username"]);
  }
}

VB.NET

Using connection As New FreshBooksConnection(connectionString)
  Dim dataAdapter As New FreshBooksDataAdapter(
    "SELECT Email, Username FROM Clients", connection)
  
  dataAdapter.UpdateCommand = New FreshBooksCommand(
    "UPDATE Clients SET Username = @Username " +
    "WHERE Id = @Id", connection)
  
  dataAdapter.UpdateCommand.Parameters.Add(new FreshBooksParameter("@Username", DbType.String, "Username"))
  dataAdapter.UpdateCommand.Parameters.Add(new FreshBooksParameter("@Id", DbType.String, "Id"))
  dataAdapter.UpdateCommand.Parameters(1).SourceVersion = DataRowVersion.Original
  
  Dim table As New DataTable()
  dataAdapter.Fill(table)
  
  Dim firstrow As DataRow = table.Rows(0)
  firstrow("Username") = "Jon Doe"
  
  dataAdapter.Update(table)
  
  Console.WriteLine("Rows after update.")
  
  For Each row As DataRow In table.Rows
    Console.WriteLine("{0}: {1}", row("Email"), row("Username"))
  Next
End Using

Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 20.0.7587