CancelUpdate メソッド

Update メソッドを呼び出す前に行った、カレント レコードまたは新しいレコードへの変更をキャンセルします。

構文

recordset.CancelUpdate

プレースホルダ recordset は、開いている Recordset オブジェクトを表すオブジェクト変数です。

解説

CancelUpdate メソッドは、カレント レコードへの変更をキャンセルしたり、新しく追加されたレコードを破棄したりするために使います。変更が RollbackTrans メソッドによるロールバック可能なトランザクションの一部であるか、あるいは CancelBatch メソッドによるキャンセル可能なバッチ更新の一部でないかぎり、Update メソッドの呼び出し後にカレント レコードや新しいレコードへの変更操作をキャンセルすることはできません。

新しいレコードの追加中に CancelUpdate メソッドを呼び出すと、AddNew メソッド呼び出しの前にカレントだったレコードが再びカレント レコードになります。

カレント レコードを変更しなかった場合、または新しいレコードを追加しなかった場合に、CancelUpdate メソッドを呼び出すとエラーになります。

対象

Recordset

関連項目

AddNewEditModeUpdate