CancelBatch 方法 (ADO)

取消挂起的批处理更新。

语法

  
recordset.CancelBatchAffectRecords  

参数

AffectRecords
可选。 一个 AffectEnum 值，指示 CancelBatch 方法将影响多少条记录。

备注

使用 CancelBatch 方法可在批处理更新模式下取消 Recordset 中的任何挂起更新。 如果 Recordset 处于即时更新模式，则调用 CancelBatch 而不调用 adAffectCurrent 将生成错误。

如果要编辑当前记录或在调用 CancelBatch 时添加新记录，ADO 会先调用 CancelUpdate 方法来取消任何缓存的更改。 之后，Recordset 中的所有挂起更改都会被取消。

在 CancelBatch 调用后，当前记录可能不确定，尤其是在添加新记录的过程中。 因此，在 CancelBatch 调用后，将当前记录位置设置为 Recordset 中的已知位置需要谨慎操作。 例如，调用 MoveFirst 方法。

例如，如果由于与基础数据发生冲突（例如，如果其他用户删除了记录），无法取消挂起的更新，那么提供程序会向错误集合返回警告，但不会停止程序执行。 仅当所有请求的记录发生冲突时，才会发生运行时错误。 使用 Filter 属性 (adFilterAffectedRecords) 和 Status 属性查找存在冲突的记录。

应用于

记录集对象 (ADO)

另请参阅

UpdateBatch 和 CancelBatch 方法示例 (VB)
UpdateBatch 和 CancelBatch 方法示例 (VC++)
Cancel 方法 (ADO)
Cancel 方法 (RDS)
CancelUpdate 方法 (ADO)
CancelUpdate 方法 (RDS)
Clear 方法 (ADO)
LockType 属性 (ADO)
UpdateBatch 方法