CancelUpdate メソッド (ADO)

[アーティクル]
05/30/2023

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

構文

  
recordset.CancelUpdaterecord.Fields.CancelUpdate

注釈

レコードセット

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

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

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