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