CancelUpdate メソッド (ADO)CancelUpdate Method (ADO)

現在のまたは新しい行に加えられた変更を取り消します、レコード セットオブジェクト、またはフィールドのコレクションをレコードオブジェクトを呼び出す前に、 Updateメソッド。Cancels any changes made to the current or new row of a Recordset object, or the Fields collection of a Record object, before calling the Update method.





使用して、 CancelUpdateメソッド、現在の行に加えられた変更をキャンセルするかを新しく追加された行を破棄します。Use the CancelUpdate method to cancel any changes made to the current row or to discard a newly added row. 呼び出した後は、現在の行または新しい行への変更を取り消すことはできません、 Updateメソッドでは、変更をロールバックできるトランザクションの一部である場合を除き、 RollbackTransメソッド、または一部バッチ更新します。You cannot cancel changes to the current row or a new row after you call the Update method, unless the changes are either part of a transaction that you can roll back with the RollbackTrans method, or part of a batch update. バッチ更新を取り消すことができます、更新で、 CancelUpdateまたはCancelBatchメソッド。In the case of a batch update, you can cancel the Update with the CancelUpdate or CancelBatch method.

呼び出すときに新しい行を追加するかどうか、 CancelUpdateメソッド、現在の行が前に、の現在の行、 AddNew呼び出します。If you are adding a new row when you call the CancelUpdate method, the current row becomes the row that was current before the AddNew call.

編集モードにし、現在のレコードから移動する場合 (などを使用して、移動NextRecordset、または閉じるメソッド) を使用することができますCancelUpdate保留中の変更をキャンセルします。If you are in edit mode and want to move off the current record (for example, by using the Move, NextRecordset, or Close methods), you can use CancelUpdate to cancel any pending changes. 更新プログラムは、データ ソースに正常に投稿できない場合に実行する必要があります。You may need to do this if the update cannot successfully be posted to the data source. たとえば、削除の試みが失敗する参照整合性違反が残ります、 Recordset呼び出しの後に編集モードで削除します。For example, an attempted delete that fails due to referential integrity violations will leave the Recordset in edit mode after a call to Delete.


CancelUpdateメソッドは、保留中の挿入または削除をキャンセルフィールドオブジェクト、および保留中の既存のフィールドの更新をキャンセルし、元の値に戻します。The CancelUpdate method cancels any pending insertions or deletions of Field objects, and cancels pending updates of existing fields and restores them to their original values. 状態のすべてのフィールドのプロパティ、フィールドに設定されているコレクションadfieldok でします。The Status property of all fields in the Fields collection is set to adFieldOK.

適用対象Applies To

Fields コレクション (ADO)Fields Collection (ADO) Recordset オブジェクト (ADO)Recordset Object (ADO)

関連項目See Also

Update および CancelUpdate メソッドの例 (VB) Update and CancelUpdate Methods Example (VB)
Update および CancelUpdate メソッドの例 (vc++) Update and CancelUpdate Methods Example (VC++)
AddNew メソッド (ADO) AddNew Method (ADO)
Cancel メソッド (ADO) Cancel Method (ADO)
Cancel メソッド (RDS) Cancel Method (RDS)
CancelBatch メソッド (ADO) CancelBatch Method (ADO)
CancelUpdate メソッド (RDS) CancelUpdate Method (RDS)
EditMode プロパティ EditMode Property
Update メソッドUpdate Method