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