次の方法で共有

CancelBatch メソッド (ADO)

  • [アーティクル]

保留中のバッチ更新を取り消します。

構文

  
recordset.CancelBatchAffectRecords

パラメーター

AffectRecords
随意。 CancelBatch メソッドが影響を受けるレコードの数を示す AffectEnum 値。

備考

CancelBatch メソッドを使用して、バッチ更新モードの Recordset で保留中の更新を取り消します。 Recordset が即時更新モードの場合、adAffectCurrent を せずに CancelBatch 呼び出すとエラーが生成されます。

現在のレコードを編集している場合、または CancelBatch を呼び出すときに新しいレコード追加する場合、ADO は最初に CancelUpdate メソッドを呼び出して、キャッシュされた変更を取り消します。 その後、Recordset のすべての保留中の変更が取り消されます。

現在のレコードは、CancelBatch 呼び出しの後で、特に新しいレコードを追加する処理中の場合は、不確定になる可能性があります。 このため、CancelBatch 呼び出しの後に、現在のレコード位置を Recordset 内の既知の場所に設定することが推奨されます。 たとえば、MoveFirst メソッドを呼び出します。

基になるデータとの競合が原因で保留中の更新を取り消そうとすると失敗した場合 (たとえば、レコードが別のユーザーによって削除された場合)、プロバイダーは Errors コレクションに警告を返しますが、プログラムの実行は停止しません。 実行時エラーは、要求されたすべてのレコードに競合がある場合にのみ発生します。 Filter プロパティ (adFilterAffectedRecords) と Status プロパティを使用して、競合するレコードを検索します。

適用対象

Recordset オブジェクト (ADO)

関連項目

UpdateBatch メソッドと CancelBatch メソッドの使用例 (VB)
UpdateBatch メソッドと CancelBatch メソッドの使用例 (VC++)
Cancel メソッド (ADO)
Cancel メソッド (RDS)
CancelUpdate メソッド (ADO)
CancelUpdate メソッド (RDS)
Clear メソッド (ADO)
LockType プロパティ (ADO)
UpdateBatch メソッドの