保存對(duì) Recordset 對(duì)象的當(dāng)前記錄所做的所有更改。
語(yǔ)法
recordset.Update Fields, Values
參數(shù)
Fields 可選。變體型,代表單個(gè)名稱;或變體型數(shù)組,代表需要修改的字段(一個(gè)或多個(gè))名稱及序號(hào)位置。
Values 可選。變體型,代表單個(gè)值;或變體型數(shù)組,代表新記錄中字段(單個(gè)或多個(gè))值。
說(shuō)明
使用 Update 方法保存自調(diào)用 AddNew 方法或更改現(xiàn)有記錄中任何字段值以來(lái)所作的所有更改。Recordset 對(duì)象必須支持更新。
要設(shè)置字段值,請(qǐng)進(jìn)行下列某項(xiàng)操作:
? | 在 Update 調(diào)用中傳送字段名和值作為參數(shù)。 |
? | 在 Update 調(diào)用中傳送字段名數(shù)組和值數(shù)組。 |
在使用字段和值的數(shù)組時(shí),兩個(gè)數(shù)組中必須有相等數(shù)量的元素,同時(shí)字段名的次序必須匹配字段值的次序。字段和值的數(shù)量及次序不匹配將產(chǎn)生錯(cuò)誤。
如果 Recordset 對(duì)象支持批更新,那么可以在調(diào)用 UpdateBatch 方法之前將一個(gè)或多個(gè)記錄的多個(gè)改動(dòng)緩存在本地。如果在調(diào)用 UpdateBatch 對(duì)象時(shí)正在編輯當(dāng)前記錄或者添加新的記錄,那么 ADO 將自動(dòng)調(diào)用 Update 方法以便在將批更改傳送到提供者之前保存掛起的更改。
如果在調(diào)用 Update 方法之前移動(dòng)出正在添加或編輯的記錄,那么 ADO 將自動(dòng)調(diào)用 Update 以便保存更改。如果希望取消對(duì)當(dāng)前記錄所做的任何更改或者放棄新添加的記錄,則必須調(diào)用 CancelUpdate 方法。
在調(diào)用 Update 方法后當(dāng)前記錄仍為當(dāng)前記錄。
如果設(shè)置了 Unique Table 動(dòng)態(tài)屬性,并且 Recordset 是對(duì)多個(gè)表執(zhí)行 JOIN 操作的結(jié)果,那么,Update 方法將無(wú)法更新多個(gè)表的任何主要關(guān)鍵字。此外,Update 只能更新在 Unique Table 屬性中指定的表中的字段。