Datasnap.DBClient.TCustomClientDataSet.BeforeRowRequest
Delphi
property BeforeRowRequest: TRemoteEvent read FBeforeRowRequest write FBeforeRowRequest;
C++
__property TRemoteEvent BeforeRowRequest = {read=FBeforeRowRequest, write=FBeforeRowRequest};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
event | protected | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
説明
クライアント データセットがカレント レコードに関する新しい情報をフェッチする前に発生します。
BeforeRowRequest イベント ハンドラを記述すると、カスタム情報をクライアント データセットのプロバイダに送信することができます。 BeforeRowRequest は、クライアント データセットとプロバイダが、データのフェッチに関する情報をやり取るするためのメカニズムの一部です。 ステートレス アプリケーション サーバーにおいてプロバイダを操作する場合、このメカニズムにより、クライアント データセットとプロバイダは、永続的な状態情報をやり取りすることが可能になります。
クライアント データセットが、カレント レコードに関する詳細情報をフェッチしたり、カレント レコードを更新したりすると、次のイベントが発生します:
- クライアント データセットが BeforeRowRequest イベントを受信。ここでは、カスタム情報を OleVariant にエンコードすることができ、それを
OwnerData
パラメータとしてプロバイダに渡す。 - アプリケーション サーバー上のプロバイダが BeforeRowRequest イベントを受信。ここでは、要求された情報を検索する前に、その情報に応答、または変更することができる。
- プロバイダが、要求された情報を含む差分パケットを作成。
- プロバイダが AfterRowRequest イベントを受信。ここでは、カスタム情報を
OwnerData
パラメータへエンコード、または、BeforeRowRequest イベント ハンドラからの情報に応答することができる。 - クライアント データセットが AfterRowRequest イベントを受信。ここでは、プロバイダの AfterRowRequest イベント ハンドラから返されたカスタム情報に応答することができる。
BeforeRowRequest は、Datasnap.DBClient.TRemoteEvent 型のイベント ハンドラです。