Datasnap.DBClient.TCustomClientDataSet.BeforeRowRequest

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

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 は、クライアント データセットとプロバイダが、データのフェッチに関する情報をやり取るするためのメカニズムの一部です。 ステートレス アプリケーション サーバーにおいてプロバイダを操作する場合、このメカニズムにより、クライアント データセットとプロバイダは、永続的な状態情報をやり取りすることが可能になります。

クライアント データセットが、カレント レコードに関する詳細情報をフェッチしたり、カレント レコードを更新したりすると、次のイベントが発生します:

  1. クライアント データセットが BeforeRowRequest イベントを受信。ここでは、カスタム情報を OleVariant にエンコードすることができ、それを OwnerData パラメータとしてプロバイダに渡す。
  2. アプリケーション サーバー上のプロバイダが BeforeRowRequest イベントを受信。ここでは、要求された情報を検索する前に、その情報に応答、または変更することができる。
  3. プロバイダが、要求された情報を含む差分パケットを作成。
  4. プロバイダが AfterRowRequest イベントを受信。ここでは、カスタム情報を OwnerData パラメータへエンコード、または、BeforeRowRequest イベント ハンドラからの情報に応答することができる。
  5. クライアント データセットが AfterRowRequest イベントを受信。ここでは、プロバイダの AfterRowRequest イベント ハンドラから返されたカスタム情報に応答することができる。

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

関連項目