CancelBatch 方法 （ADO）

取消擱置的批次更新。

語法

  
recordset.CancelBatchAffectRecords  

參數

AffectRecords
自選。 AffectEnum 值，指出 CancelBatch 方法會影響多少筆記錄。

言論

使用 CancelBatch 方法來取消批次更新模式中 Recordset 中任何擱置的更新。 如果 Recordset 處於立即更新模式，則呼叫 CancelBatch 而不 adAffectCurrent 會產生錯誤。

如果您要編輯當前記錄，或在呼叫 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 方法