次の方法で共有

Update メソッド

  • [アーティクル]

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

構文

  
recordset.Update Fields, Values  
record.Fields.Update

パラメーター

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

値
随意。 1 つの値を表す Variant、または新しいレコードのフィールドまたはフィールドの値を表す Variant 配列。

備考

Recordset

Update メソッドを使用して、AddNew メソッドを呼び出した後、または既存のレコードのフィールド値を変更した後で、Recordset オブジェクトの現在のレコードに加えた変更を保存します。 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 メソッドの