Update メソッド (ADO)
適用先: Access 2013、Office 2013
Recordset オブジェクトのカレント行、または Record オブジェクトの Fields コレクションに加えた変更を保存します。
構文
recordset。フィールド、値の更新
レコード。 フィールド。更新
パラメーター
| パラメーター | 説明 |
|---|---|
| フィールド | 省略可能です。 変更する単一のフィールドの名前を表すバリアント型 ( Variant ) の値、または複数のフィールドの名前か順序を表すバリアント型 ( Variant ) の配列を指定します。 |
| Values | 省略可能です。 新しいレコードでの単一のフィールドの値を表すバリアント型 (Variant) の値、または複数のフィールドの値を表すバリアント型 (Variant) の配列を指定します。 |
注釈
Recordset
Update メソッドを使用すると、 AddNew メソッドを呼び出したか、または既存レコードのいずれかのフィールドの値を変更した時点以降に Recordset オブジェクトのカレント レコードに加えた変更がすべて保存されます。 Recordset オブジェクトが更新をサポートしている必要があります。
フィールドの値を設定するには、次のいずれかを行います。
フィールド名と値を Update 呼び出しで引数として渡します。
フィールド名の配列と値の配列を Update 呼び出しで渡します。
フィールドと値の配列を使用する場合は、両方の配列の要素の数を同じにする必要があります。 また、フィールド名の順序がフィールドの値の順序と一致している必要があります。 フィールドと値の数と順序が一致していないと、エラーが発生します。
Recordset オブジェクトが一括更新をサポートしている場合は、1 つまたは複数のレコードへの複数の変更をローカルにキャッシュしてから、 UpdateBatch メソッドを呼び出すことができます。 カレント レコードの編集中、または新しいレコードの追加中に UpdateBatch メソッドを呼び出すと、ADO によって自動的に Update メソッドが呼び出されてカレント レコードへの保留中の変更が保存されてから、変更内容がまとめてプロバイダーに転送されます。
Update メソッドを呼び出すより前に追加中または編集中のレコードから移動すると、ADO によって自動的に Update が呼び出されて変更内容が保存されます。 カレント レコードに加えた変更を取り消す場合や、新しく追加したレコードを破棄する場合は、 CancelUpdate メソッドを呼び出す必要があります。
カレント レコードは、 Update メソッドを呼び出した後もカレントのままです。
録音する
Update メソッドは、 Record オブジェクトの Fields コレクションへのフィールドの追加、削除、および更新を完了させます。
たとえば、 Delete メソッドで削除されたフィールドは、直ちに削除のマークが付けられますが、コレクション内には残されます。 これらのフィールドをプロバイダーのコレクションから実際に削除するには、 Update メソッドを呼び出す必要があります。