Datasnap.DBClient.TCustomClientDataSet.AfterApplyUpdates

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

property AfterApplyUpdates: TRemoteEvent read FAfterApplyUpdates write FAfterApplyUpdates;

C++

__property TRemoteEvent AfterApplyUpdates = {read=FAfterApplyUpdates, write=FAfterApplyUpdates};

プロパティ

種類 可視性 ソース ユニット
event protected
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet


説明

クライアント データセットがプロバイダ側に更新を適用し、更新エラーを調整しようとするまでの間に発生します。

AfterApplyUpdates イベント ハンドラを記述すると、プロバイダの AfterApplyUpdates イベント ハンドラからクライアント データセットへ返された、カスタム情報に応答することができます。AfterApplyUpdates は、クライアント データセットとプロバイダが、更新に関する情報をやり取るするためのメカニズムの一部です。ステートレス アプリケーション サーバーにおいてプロバイダを操作する場合、このメカニズムにより、クライアント データセットとプロバイダは、永続的な状態情報をやり取りすることが可能になります。

アプリケーションがクライアント データセットの ApplyUpdates メソッドを呼び出した際、次のイベントが発生します:

  1. クライアント データセットが BeforeApplyUpdates イベントを受信。ここでは、カスタム情報を OleVariant にエンコードすることができ、それを OwnerData パラメータとしてプロバイダに渡す。
  2. プロバイダが BeforeApplyUpdates イベントを受信。ここでは、更新を適用する前に、その情報に応答、または変更することができる。
  3. プロバイダが更新を適用。そして問題にあるレコードに対しては OnUpdateError イベントを受信。
  4. プロバイダが AfterApplyUpdates イベントを受信。ここでは、カスタム情報を OwnerData パラメータへエンコード、または、BeforeApplyUpdates イベント ハンドラからの情報に応答することができる。
  5. クライアント データセットが AfterApplyUpdates イベントを受信。ここでは、プロバイダの AfterApplyUpdates イベント ハンドラから返されたカスタム情報に応答することができる。
  6. クライアント データセットは、プロバイダが適用できなかった各レコードに対して、OnReconcileError を生成。

AfterApplyUpdates は、Datasnap.DBClient.TRemoteEvent 型のイベント ハンドラです。

関連項目