Update メソッド
Recordset オブジェクトの現在の行、または Record オブジェクトの Fields コレクションに加えた変更をすべて保存します。
構文
recordset.Update Fields, Values
record.Fields.Update
パラメーター
Fields
省略可能。 1 つの名前を表す Variant、または変更するフィールドの名前または序数位置を表す Variant 配列。
値
省略可能。 1 つの値を表す Variant、または新しいレコード内のフィールドの値を表す Variant 配列。
注釈
レコードセット
AddNew メソッドを呼び出した後、または既存のレコードのフィールド値を変更した後で Recordset オブジェクトの現在のレコードに加えた変更を保存するには、Update メソッドを使用します。 Recordset オブジェクトでは更新をサポートする必要があります。
フィールド値を設定するには、次のいずれかの操作を行います。
Update 呼び出しでフィールド名と値を引数として渡す。
Update 呼び出しで、フィールド名の配列と値の配列を渡す。
フィールドと値の配列を使用する場合、両方の配列に等しい数の要素が必要です。 また、フィールド名の順序はフィールド値の順序と一致する必要があります。 フィールドと値の数と順序が一致しない場合は、エラーが発生します。
Recordset オブジェクトでバッチ更新がサポートされている場合は、UpdateBatch メソッドを呼び出すまで、1 つまたは複数のレコードに複数の変更をキャッシュすることができます。 UpdateBatch メソッドを呼び出すときに現在のレコードを編集する場合、または新しいレコードを追加する場合、ADO を使用すると、Update メソッドが自動的に呼び出されます。これにより、保留中の変更が現在のレコードに保存されると、バッチ処理された変更がプロバイダーに送信されます。
Update メソッドを呼び出す前に追加または編集しているレコードから移動すると、ADO によって Update が自動的に呼び出され、変更が保存されます。 現在のレコードに加えられた変更を取り消す場合、または新しく追加したレコードを破棄する場合は、CancelUpdate メソッドを呼び出す必要があります。
Update メソッドを呼び出した後も、現在のレコードは最新のままです。
レコード
Update メソッドでは、Record オブジェクトの Fields コレクション内のフィールドに対する追加、削除、および更新を最終処理します。
たとえば、Delete メソッドで削除されたフィールドは、すぐに削除対象としてマークされますが、コレクション内に残ります。 プロバイダーのコレクションからこれらのフィールドを実際に削除するには、Update メソッドを呼び出す必要があります。
適用対象
参照
Update および CancelUpdate メソッドの例 (VB)
Update および CancelUpdate メソッドの例 (VC++)
AddNew メソッド (ADO)
CancelUpdate メソッド (ADO)
EditMode プロパティ
UpdateBatch メソッド