Update 方法

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

语法

  
recordset.Update Fields, Values  
record.Fields.Update  

参数

字段
可选。 一个表示单个名称的 Variant,或一个表示要修改的字段的名称或序号位置的 Variant 数组。


可选。 一个表示单个值的 Variant,或一个表示新记录中字段的值的 Variant 数组。

备注

记录集

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

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

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

  • 使用 Update 调用将字段名称和值作为自变量传递。

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

使用字段和值的数组时,这两个数组中的元素数必须相等。 此外,字段名称的顺序必须与字段值的顺序相匹配。 如果字段和值的数量和顺序不匹配,则会发生错误。

如果 Recordset 对象支持批量更新,则可以在本地缓存对一条或多条记录所做的多项更改,直至调用 UpdateBatch 方法。 如果在调用 UpdateBatch 方法时编辑当前记录或添加新记录,ADO 将自动调用 Update 方法,将任何挂起的更改保存到当前记录,然后再将批处理更改传输到提供程序。

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

调用 Update 方法后,当前记录保持最新状态。

记录

Update 方法完成对 Record 对象的 Fields 集合中的字段的添加、删除和更新。

例如,使用 Delete 方法删除的字段将立即标记为删除,但保留在集合中。 必须调用 Update 方法才能将这些字段真正从提供程序的集合中删除。

应用于

另请参阅

Update 和 CancelUpdate 方法示例 (VB)
Update 和 CancelUpdate 方法示例 (VC++)
AddNew 方法 (ADO)
CancelUpdate 方法 (ADO)
EditMode 属性
UpdateBatch 方法