CancelUpdate メソッド (ADO)

  • [アーティクル]

適用先: Access 2013、Office 2013

Update メソッドを呼び出す前に行った、Recordset オブジェクトのカレント行や新規行に対する変更、または Record オブジェクトの Fields コレクションに対する変更を、すべてキャンセルします。

構文

recordset。CancelUpdate

レコード。フィールド。CancelUpdate

注釈

Recordset

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

新しい行を追加している場合は、 CancelUpdate メソッドを呼び出すと、 AddNew を呼び出す前にカレントであった行がカレント行になります。

編集モードでカレント レコードから移動する (たとえば、Move、NextRecordset、または Close を使用して) 場合は、 CancelUpdate を使用して、保留中のすべての変更を取り消すこどができます。 データ ソースの更新が成功しなかった場合 (たとえば、参照整合性違反のために削除の試みが失敗し、 Delete の呼び出しの後で Recordset が編集モードのままになった場合) には、この処理が必要になることがあります。

Record

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