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

保留中のバッチ更新をキャンセルします。Cancels a pending batch update.

構文Syntax

  
recordset.CancelBatchAffectRecords  

パラメーターParameters

AffectRecordsAffectRecords
任意。Optional. AffectEnumレコードの数を示す値、 CancelBatchメソッドに影響されます。An AffectEnum value that indicates how many records the CancelBatch method will affect.

コメントRemarks

使用して、 CancelBatch保留中の更新プログラムをキャンセルするメソッド、レコード セットバッチ更新モードでします。Use the CancelBatch method to cancel any pending updates in a Recordset in batch update mode. 場合、レコード セットが即時更新モードで呼び出すCancelBatchせずadAffectCurrentエラーが生成されます。If the Recordset is in immediate update mode, calling CancelBatch without adAffectCurrent generates an error.

現在のレコードを編集して、呼び出すときに、新しいレコードを追加するかCancelBatch、ADO を最初に呼び出す、 CancelUpdateキャッシュされた変更をキャンセルするメソッド。If you are editing the current record or are adding a new record when you call CancelBatch, ADO first calls the CancelUpdate method to cancel any cached changes. 保留中のすべての変更、その後、 Recordsetは取り消されます。After that, all pending changes in the Recordset are canceled.

現在のレコードを後で確定できない可能性があります、 CancelBatch呼び出すには中、新しいレコードを追加した場合に特にです。The current record may be indeterminable after a CancelBatch call, especially if you were in the process of adding a new record. このためがの既知の場所に現在のレコードの位置を設定することをお勧め、レコード セット後、 CancelBatch呼び出します。For this reason, it is prudent to set the current record position to a known location in the Recordset after the CancelBatch call. たとえば、呼び出し、 MoveFirstメソッド。For example, call the MoveFirst method.

プロバイダーは警告を返します (たとえば、レコードが別のユーザーによって削除されている場合) の基になるデータの競合があるため、保留中の更新をキャンセルの試行に失敗した場合、エラーコレクションは停止されませんが、プログラムの実行。If the attempt to cancel the pending updates fails because of a conflict with the underlying data (for example, if a record has been deleted by another user), the provider returns warnings to the Errors collection but does not halt program execution. 要求されたすべてのレコードの競合がある場合にのみ、実行時エラーが発生します。A run-time error occurs only if there are conflicts on all the requested records. 使用して、フィルタープロパティ (adFilterAffectedRecords) および状態が競合しているレコードを検索するプロパティ。Use the Filter property (adFilterAffectedRecords) and the Status property to locate records with conflicts.

適用対象Applies To

Recordset オブジェクト (ADO)Recordset Object (ADO)

関連項目See Also

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