API:SimpleDS.TSimpleDataSet.BeforeApplyUpdates

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

Delphi

property BeforeApplyUpdates: TRemoteEvent read FBeforeApplyUpdates write FBeforeApplyUpdates;

C++

__property BeforeApplyUpdates;

プロパティ

種類 可視性 ソース ユニット
event published
SimpleDS.pas
SimpleDS.hpp
SimpleDS TSimpleDataSet

説明

クライアント データセットがリモート サーバーへ更新を適用する前に発生します。

SimpleDS.TSimpleDataSet.BeforeApplyUpdates は Datasnap.DBClient.TCustomClientDataSet.BeforeApplyUpdates を継承しています。以下の内容はすべて Datasnap.DBClient.TCustomClientDataSet.BeforeApplyUpdates を参照しています。

クライアント データセットがリモート サーバーへ更新を適用する前に発生します。

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

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

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

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

関連項目