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 方法之後，目前的記錄會維持目前狀態。

Record

Update 方法會完成 Record 物件 Fields 集合中欄位的新增、刪除和更新。

例如，使用 Delete 方法刪除的欄位會立即標示為刪除，但仍保留在集合中。 您必須呼叫 Update 方法，才能確實從提供者的集合中刪除這些欄位。

套用至

Fields 集合 (ADO)

Recordset 物件 (ADO)

另請參閱

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