API:SimpleDS.TSimpleDataSet.AfterApplyUpdates
Delphi
property AfterApplyUpdates;
C++
__property AfterApplyUpdates;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| event | published | SimpleDS.pas SimpleDS.hpp |
SimpleDS | TSimpleDataSet |
説明
クライアント データセットがプロバイダ側に更新を適用し、更新エラーを調整しようとするまでの間に発生します。
SimpleDS.TSimpleDataSet.AfterApplyUpdates は Datasnap.DBClient.TCustomClientDataSet.AfterApplyUpdates を継承しています。以下の内容はすべて Datasnap.DBClient.TCustomClientDataSet.AfterApplyUpdates を参照しています。
クライアント データセットがプロバイダ側に更新を適用し、更新エラーを調整しようとするまでの間に発生します。
AfterApplyUpdates イベント ハンドラを記述すると、プロバイダの AfterApplyUpdates イベント ハンドラからクライアント データセットへ返された、カスタム情報に応答することができます。AfterApplyUpdates は、クライアント データセットとプロバイダが、更新に関する情報をやり取るするためのメカニズムの一部です。ステートレス アプリケーション サーバーにおいてプロバイダを操作する場合、このメカニズムにより、クライアント データセットとプロバイダは、永続的な状態情報をやり取りすることが可能になります。
アプリケーションがクライアント データセットの ApplyUpdates メソッドを呼び出した際、次のイベントが発生します：
- クライアント データセットが BeforeApplyUpdates イベントを受信。ここでは、カスタム情報を OleVariant にエンコードすることができ、それを
OwnerDataパラメータとしてプロバイダに渡す。 - プロバイダが BeforeApplyUpdates イベントを受信。ここでは、更新を適用する前に、その情報に応答、または変更することができる。
- プロバイダが更新を適用。そして問題にあるレコードに対しては OnUpdateError イベントを受信。
- プロバイダが AfterApplyUpdates イベントを受信。ここでは、カスタム情報を
OwnerDataパラメータへエンコード、または、BeforeApplyUpdates イベント ハンドラからの情報に応答することができる。 - クライアント データセットが AfterApplyUpdates イベントを受信。ここでは、プロバイダの AfterApplyUpdates イベント ハンドラから返されたカスタム情報に応答することができる。
- クライアント データセットは、プロバイダが適用できなかった各レコードに対して、OnReconcileError を生成。
AfterApplyUpdates は、Datasnap.DBClient.TRemoteEvent 型のイベント ハンドラです。