Update メソッド

  • [アーティクル]

Recordset オブジェクトの現在の行、または Record オブジェクトの Fields コレクションに加えた変更をすべて保存します。

構文

  
recordset.Update Fields, Values  
record.Fields.Update

パラメーター

Fields
省略可能。 1 つの名前を表す Variant、または変更するフィールドの名前または序数位置を表す Variant 配列。

値
省略可能。 1 つの値を表す Variant、または新しいレコード内のフィールドの値を表す Variant 配列。

注釈

レコードセット

AddNew メソッドを呼び出した後、または既存のレコードのフィールド値を変更した後で Recordset オブジェクトの現在のレコードに加えた変更を保存するには、Update メソッドを使用します。 Recordset オブジェクトでは更新をサポートする必要があります。

フィールド値を設定するには、次のいずれかの操作を行います。

  • Field オブジェクトの Value プロパティに値を割り当てて、Update メソッドを呼び出す。

  • Update 呼び出しでフィールド名と値を引数として渡す。

  • Update 呼び出しで、フィールド名の配列と値の配列を渡す。

フィールドと値の配列を使用する場合、両方の配列に等しい数の要素が必要です。 また、フィールド名の順序はフィールド値の順序と一致する必要があります。 フィールドと値の数と順序が一致しない場合は、エラーが発生します。

Recordset オブジェクトでバッチ更新がサポートされている場合は、UpdateBatch メソッドを呼び出すまで、1 つまたは複数のレコードに複数の変更をキャッシュすることができます。 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 メソッド