更新方法 (ADO)

适用于:Access 2013、Office 2013

可保存对 Recordset 对象的当前行或 Record 对象的 Fields 集合所做的任何更改。

语法

recordset。更新字段

记录字段。更新

参数

参数 说明
Fields 可选。 一个表示单个名称的 Variant,或表示要修改的字段的名称或序号位置的 Variant 数组。
Values 可选。 一个表示单个名称的 Variant,或表示新记录中字段值的 Variant 数组。

备注

Recordset

使用 Update 方法可以保存自调用 AddNew 方法或更改现有记录中的任何字段值之后对 Recordset 对象的当前记录所做的任何更改。 Recordset 对象必须支持更新。

若要设置字段值,请执行下列操作之一:

  • 将值赋给 Field 对象的 Value 属性并调用 Update 方法。

  • 调用 Update 时将字段名和值作为参数传递。

  • 调用 Update 时传递字段名数组和值数组。

在使用字段和值的数组时,两个数组中的元素个数必须相同。 同时,字段名的次序必须与字段值的次序匹配。 如果字段和值的个数和次序不匹配,则会发生错误。

如果 Recordset 对象支持批更新,则在调用 UpdateBatch 方法前,可以在本地缓存对一个或多个记录所做的多次更改。 如果在调用 UpdateBatch 方法时正在编辑当前记录或添加新记录,则 ADO 在将批更改传输到提供程序前,将自动调用 Update 方法将所有挂起的更改保存到当前记录。

如果在调用 Update 方法之前从正在添加或编辑的记录移开,则 ADO 将自动调用 Update 来保存所做的更改。 如果要取消对当前记录所做的更改或放弃新添加的记录,则必须调用 CancelUpdate 方法。

调用 Update 方法之后,当前记录仍然是当前记录。

记录

可以使用 Update 方法完成在 Record 对象的 Fields 集合中添加、删除或更新字段的操作。

例如,用 Delete 方法删除的字段被立即加上删除标记,但仍保留在集合中。 必须调用 Update 方法来从提供程序的集合中实际删除这些字段。