共用方式為

Update 方法

  • 發行項

儲存您對 Recordset 物件目前數據列所做的任何變更，或 Record 物件的 Fields 集合。

語法

  
recordset.Update Fields, Values  
record.Fields.Update

參數

欄位
自選。 代表單一名稱的 Variant，或是代表您想要修改之欄位或欄位名稱或序數位置的 Variant 陣列。

值
自選。 代表單一值的 Variant，或是代表新記錄中欄位或欄位值的 Variant 陣列。

言論

Recordset

使用 Update 方法來儲存您對 Recordset 物件目前記錄所做的任何變更，因為呼叫 AddNew 方法，或變更現有記錄中的任何域值。 Recordset 物件必須支援更新。

若要設定域值，請執行下列其中一項：

  • 將值指派給 Field 物件的 Value 屬性，並呼叫 Update 方法。

  • 使用 Update 呼叫，傳遞功能變數名稱和值做為自變數。

  • 使用 Update 呼叫，傳遞功能變數名稱陣列和值的陣列。

當您使用欄位和值的陣列時，這兩個陣列中的元素數目必須相等。 此外，功能變數名稱的順序必須符合域值的順序。 如果欄位和值的數目和順序不相符，就會發生錯誤。

如果 Recordset 物件支援批次更新，您可以在本機快取一或多個記錄的多個變更，直到您呼叫 UpdateBatch 方法為止。 如果您在呼叫 UpdateBatch 方法時編輯當前記錄或新增新記錄，ADO 會自動呼叫 Update 方法，以儲存目前記錄的任何暫止變更，再將批次變更傳送給提供者。

如果您在呼叫 Update 方法之前從要新增或編輯的記錄移動，ADO 會自動呼叫 Update 以儲存變更。 如果您想要取消對當前記錄所做的任何變更，或捨棄新加入的記錄，則必須呼叫 CancelUpdate 方法。

呼叫 Update 方法之後，目前的記錄會維持目前狀態。

記錄

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

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

適用於

Fields 集合 （ADO）

Recordset 物件 （ADO）

另請參閱

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