CDaoRecordset::Update

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

この関数は、AddNew メンバ関数または Edit メンバ関数の呼び出しの後に呼び出します。

virtual void Update( );

解説

この関数を呼び出すことによって、AddNew または Edit の操作を完了します。

AddNew 関数および Edit 関数はどちらも、データソースに保存するための追加または更新されたデータを置く編集バッファを準備します。Update はデータを保存します。変更されたことが示されているフィールド、または変更されたことが検出されたフィールドだけを更新します。

データソースでトランザクションがサポートされている場合は、トランザクションの一部として、Update 関数 (および対応する AddNew 関数や Edit 関数) を呼び出すことができます。

注意 :
最初に AddNew または Edit を呼び出さずに Update を呼び出すと、Update は CDaoException をスローします。AddNew または Edit を呼び出す場合、MoveNext を呼び出すか、レコードセットまたはデータソースの接続のどちらかを閉じる前に、Update を呼び出す必要があります。呼び出さないと、変更は警告なしで失われます。

最初に AddNew または Edit を呼び出さずに Update を呼び出すと、Update は CDaoException をスローします。AddNew または Edit を呼び出す場合、MoveNext を呼び出すか、レコードセットまたはデータソースの接続のどちらかを閉じる前に、Update を呼び出す必要があります。呼び出さないと、変更は警告なしで失われます。

マルチユーザー環境でレコードセットオブジェクトが排他ロックされているときは、レコードは Edit が呼び出されてから更新が完了するまでロックされたままになります。レコードセットが共有ロックされている場合、レコードはロックされ、データベースでそのレコードが更新される直前に、編集前のレコードと比較されます。Edit が呼び出された後にレコードが変更されていると、Update 操作は失敗し、MFC は例外をスローします。SetLockingMode を使用して、ロックモードを変更できます。