次の方法で共有

CancelUpdate メソッド (ADO)

  • [アーティクル]

Update メソッドを呼び出す前に、Recordset オブジェクトの現在または新しい行、または Record オブジェクトの Fields コレクションに加えられた変更を取り消します。

構文

  
recordset.CancelUpdaterecord.Fields.CancelUpdate

備考

Recordset

現在の行に加えられた変更を取り消したり、新しく追加した行を破棄したりするには、CancelUpdate メソッドを使用します。 Update メソッドを呼び出した後、現在の行または新しい行に対する変更を取り消すことはできません。ただし、変更が、RollbackTrans メソッドでロールバックできるトランザクションの一部であるか、バッチ更新の一部である場合を除きます。 バッチ更新の場合は、CancelUpdate または CancelBatch メソッドを使用して、Update 取り消すことができます。

CancelUpdate メソッドを呼び出すときに新しい行を追加する場合、現在の行は、AddNew 呼び出しの前に現在の行になります。

編集モードで現在のレコードから移動する場合 (たとえば、Move、NextRecordset、または Close メソッドを使用する場合)、CancelUpdate を使用して保留中の変更を取り消すことができます。 更新プログラムをデータ ソースに正常に投稿できない場合は、これを行う必要があります。 たとえば、参照整合性違反が原因で失敗した削除を試行すると、Deleteの呼び出しの後、Recordset が編集モードのままになります。

記録

CancelUpdate メソッドは、Field オブジェクトの保留中の挿入または削除を取り消し、既存のフィールドの保留中の更新を取り消し、元の値に復元します。 Fields コレクション内のすべてのフィールドの Status プロパティは、adFieldOK に設定されます。

適用対象

Fields コレクション (ADO)

Recordset オブジェクト (ADO)

関連項目

Update メソッドと CancelUpdate メソッドの使用例 (VB)
Update メソッドと CancelUpdate メソッドの使用例 (VC++)
AddNew メソッド (ADO)
Cancel メソッド (ADO)
Cancel メソッド (RDS)
CancelBatch メソッド (ADO)
CancelUpdate メソッド (RDS)
EditMode プロパティ
Update メソッドの