データの変更

アダプターのUpdate メソッドを使用して、データを更新します。このオーバーロードされたメソッドは、パラメータとしてDataTable を受け取ることができ、データソースに対して行われたすべての変更をコミットします。データテーブルの名前は、引数として渡すことができ、従来の方法でデータセット全体を更新するためにも使用されます。データテーブルをUpdate メソッドへの引数として使用する場合、アダプターは、データテーブルに対して行われた変更を評価し、行ごとに適切なコマンド（INSERT、UPDATE、またはDELETE）を実行します。

次の例は、[CData].[Employee Management].Leave_Types エントリの1つであるLeave_Type を更新します。

using (ZohoCreatorConnection connection = new ZohoCreatorConnection(connectionString)) {
  ZohoCreatorDataAdapter dataAdapter = new ZohoCreatorDataAdapter(
    "SELECT ID, Leave_Type FROM [CData].[Employee Management].Leave_Types", connection);

  dataAdapter.UpdateCommand = new ZohoCreatorCommand(
    "UPDATE [CData].[Employee Management].Leave_Types SET Leave_Type = @Leave_Type " +
    "WHERE Id = @Id", connection);
 
  dataAdapter.UpdateCommand.Parameters.Add(new ZohoCreatorParameter("@Leave_Type", "Leave_Type", DbType.String ));
  dataAdapter.UpdateCommand.Parameters.Add(new ZohoCreatorParameter("@Id", "Id", DbType.String ));
  dataAdapter.UpdateCommand.Parameters[1].SourceVersion = DataRowVersion.Original;

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

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

  dataAdapter.Update(table);

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

VB.NET

Using connection As New ZohoCreatorConnection(connectionString)
  Dim dataAdapter As New ZohoCreatorDataAdapter(
    "SELECT ID, Leave_Type FROM [CData].[Employee Management].Leave_Types", connection)
  
  dataAdapter.UpdateCommand = New ZohoCreatorCommand(
    "UPDATE [CData].[Employee Management].Leave_Types SET Leave_Type = @Leave_Type " +
    "WHERE Id = @Id", connection)
  
  dataAdapter.UpdateCommand.Parameters.Add(new ZohoCreatorParameter("@Leave_Type", "Leave_Type" DbType.String ))
  dataAdapter.UpdateCommand.Parameters.Add(new ZohoCreatorParameter("@Id", "Id", DbType.String))
  dataAdapter.UpdateCommand.Parameters(1).SourceVersion = DataRowVersion.Original
  
  Dim table As New DataTable()
  dataAdapter.Fill(table)
  
  Dim firstrow As DataRow = table.Rows(0)
  firstrow("Leave_Type") = "Jon Doe"
  
  dataAdapter.Update(table)
  
  Console.WriteLine("Rows after update.")
  
  For Each row As DataRow In table.Rows
    Console.WriteLine("{0}: {1}", row("ID"), row("Leave_Type"))
  Next
End Using

CData メソッドの拡張

INSERT を実行した後に複合主キーを取得する場合、どのようなタイプのINSERT が実行されたかによって最適なメソッドが異なります。

INSERT が単一の更新 / 削除ステートメントであった場合は、connection.GetLastResult() メソッドを使用して、挿入されたID を取得します。

INSERT がバッチ操作で、1行のみ更新された場合は、connection.GetLastResult() を使用して挿入されたID を取得します。これは、単一の更新 / 削除からID を取得するのと同じです。

INSERT がバッチ操作で、複数行が更新された場合は、直接SYS_LASTRESULTINFO にクエリを実行してLASTRESULTINTO#TEMP テーブルから挿入されたID を取得します。

ADO.NET Provider for Zoho Creator

データの変更

CData メソッドの拡張