通过

CancelUpdate 方法 (ADO)

  • 项目

适用于：Access 2013、Office 2013

在调用 Update 方法之前，取消对 Recordset 对象的当前行或新行，或对 Record 对象的 Fields 集合所做的任何更改。

语法

recordset。CancelUpdate

记录。字段。CancelUpdate

备注

Recordset

可以使用 CancelUpdate 方法取消对当前行所做的任何更改或放弃新添加的行。 但调用 Update 方法之后，便无法取消对当前行或新行所做的更改，除非更改是可以用 RollbackTrans 方法回滚的事务的一部分或批更新的一部分。 在批更新情况下，可以用 CancelUpdate 或 CancelBatch 方法取消 Update 。

如果调用 CancelUpdate 方法时正在添加新行，则当前行将变成调用 AddNew 之前的当前行。

如果正处于编辑模式下，并希望离开当前记录（例如，用 Move、NextRecordset 或 Close），那么可以使用 CancelUpdate 取消任何挂起的更改。 如果更新无法成功发布到数据源，则可能需要执行以上操作（例如，如果删除尝试由于违反了参照完整性而失败，则在调用 Delete 之后将离开处于编辑模式下的 Recordset ）。

Record

可以使用 CancelUpdate 方法取消 Field 对象的任何挂起的插入或删除，以及取消现有字段的挂起更新并将其还原为原来的值。 Fields 集合中所有字段的 Status 属性均设置为 adFieldOK 。