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 方法