Update メソッドUpdate Method

現在の行に加えた変更を保存、レコード セットオブジェクト、またはフィールドのコレクションをレコードオブジェクト。Saves any changes you make to the current row of a Recordset object, or the Fields collection of a Record object.

構文Syntax

  
recordset.Update Fields, Values  
record.Fields.Update  

パラメーターParameters

FieldsFields
任意。Optional. Aバリアントを表す 1 つの名前またはバリアント名または変更するフィールドの序数位置を表す配列。A Variant that represents a single name, or a Variant array that represents names or ordinal positions of the field or fields you wish to modify.

Values
任意。Optional. Aバリアントを表す 1 つの値またはバリアントフィールドまたは新しいレコードのフィールドの値を表す配列。A Variant that represents a single value, or a Variant array that represents values for the field or fields in the new record.

コメントRemarks

レコードセットRecordset

使用して、更新の現在のレコードに加えた変更を保存する方法、レコード セットオブジェクトを呼び出した後、 AddNewメソッドまたは内のフィールドの値を変更した後、既存のレコード。Use the Update method to save any changes you make to the current record of a Recordset object since calling the AddNew method or since changing any field values in an existing record. Recordsetオブジェクトは、更新プログラムをサポートする必要があります。The Recordset object must support updates.

フィールドの値を設定するには、次のいずれかの操作を行います。To set field values, do one of the following:

  • 値を割り当てる、フィールドオブジェクトのプロパティと呼び出し、 Updateメソッド。Assign values to a Field object's Value property and call the Update method.

  • フィールドの名前と値を引数として渡す、 Update呼び出します。Pass a field name and a value as arguments with the Update call.

  • フィールド名の配列と値の配列を渡す、 Update呼び出します。Pass an array of field names and an array of values with the Update call.

フィールドと値の配列を使用する場合は、両方の配列内の要素の数が等しい必要があります。When you use arrays of fields and values, there must be an equal number of elements in both arrays. また、フィールド名の順序は、フィールドの値の順序と一致する必要があります。Also, the order of field names must match the order of field values. フィールドと値の順序と数が一致しない場合は、エラーが発生します。If the number and order of fields and values do not match, an error occurs.

場合、 Recordsetオブジェクトは、バッチ更新をサポートしているを呼び出すまで、ローカルでは、1 つまたは複数のレコードに複数の変更をキャッシュすることができます、 UpdateBatchメソッド。If the Recordset object supports batch updating, you can cache multiple changes to one or more records locally until you call the UpdateBatch method. 現在のレコードを編集または呼び出すときに新しいレコードを追加する場合、 UpdateBatchメソッド、ADO の呼び出しが自動的に、 Updateメソッドの前に、現在のレコードに保留中の変更を保存するにはプロバイダーにバッチ処理された変更を送信します。If you are editing the current record or adding a new record when you call the UpdateBatch method, ADO will automatically call the Update method to save any pending changes to the current record before transmitting the batched changes to the provider.

レコードから移動した場合の追加または編集する呼び出しの前に、 Updateメソッド、ADO の呼び出しが自動的にUpdate変更を保存します。If you move from the record you are adding or editing before calling the Update method, ADO will automatically call Update to save the changes. 呼び出す必要があります、 CancelUpdateメソッド、現在のレコードに加えられた変更をキャンセルするか、新しく追加したレコードを破棄する場合。You must call the CancelUpdate method if you want to cancel any changes made to the current record or discard a newly added record.

現在のレコードを呼び出した後は、最新の状態、 Updateメソッド。The current record remains current after you call the Update method.

レコードRecord

Updateメソッドは、追加、削除、および内のフィールドに対する更新を終了、フィールドのコレクションをレコードオブジェクト。The Update method finalizes additions, deletions, and updates to fields in the Fields collection of a Record object.

削除されたフィールドなど、削除メソッドがすぐに削除対象としてマークがコレクションに残ります。For example, fields deleted with the Delete method are marked for deletion immediately but remain in the collection. Updateを実際には、プロバイダーのコレクションからこれらのフィールドを削除するメソッドを呼び出す必要があります。The Update method must be called to actually delete these fields from the provider's collection.

適用対象Applies To

Fields コレクション (ADO)Fields Collection (ADO) Recordset オブジェクト (ADO)Recordset Object (ADO)

参照See Also

Update および CancelUpdate メソッドの例 (VB) Update and CancelUpdate Methods Example (VB)
Update および CancelUpdate メソッドの例 (vc++) Update and CancelUpdate Methods Example (VC++)
AddNew メソッド (ADO) AddNew Method (ADO)
CancelUpdate メソッド (ADO) CancelUpdate Method (ADO)
EditMode プロパティ EditMode Property
UpdateBatch メソッドUpdateBatch Method