Datasnap.Provider.TDataSetProvider.BeforeGetRecords

提供:RAD Studio API Documentation

Delphi

property BeforeGetRecords: TRemoteEvent read FBeforeGetRecords write FBeforeGetRecords;

C++

__property BeforeGetRecords;

プロパティ

種類 可視性 ソース ユニット
event published
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TDataSetProvider

説明

プロバイダが、データ パケットを作成し、クライアント データセットに送信する前に発生します。 {{#multireplace:Datasnap.Provider.TDataSetProvider.BeforeGetRecords|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:Datasnap.Provider.TCustomProvider.BeforeGetRecords|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:Datasnap.Provider.TCustomProvider.BeforeGetRecords|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。

プロバイダが、データ パケットを作成し、クライアント データセットに送信する前に発生します。

BeforeGetRecords イベント ハンドラを記述すると、クライアント データセットからのカスタム情報に応答できます。 BeforeGetRecords は、クライアント データセットとプロバイダが、データのフェッチに関する情報をやり取るするためのメカニズムの一部です。 プロバイダがステートレス アプリケーション サーバーの一部である場合、このメカニズムにより、クライアント データセットとプロバイダは、永続的な状態情報をやり取りすることが可能になります。

クライアント データセットがプロバイダからデータをフェッチした際、次のイベントが発生します:

1. クライアント データセットが BeforeGetRecords イベントを受信。ここでは、カスタム情報を OleVariant にエンコード。

2. プロバイダが BeforeGetRecords イベントを受信。ここでは、クライアント データセットからの OleVariant が OwnerData パラメータとして渡される。 プロバイダは、データ パケットを作成する前に、それに対応もしくはその情報を変更することができる。

3. プロバイダがデータ パケットを生成。

4. プロバイダが AfterGetRecords イベントを受信。ここでは、カスタム情報を OwnerData パラメータへエンコード、または、BeforeGetRecords イベント ハンドラからの情報に応答することができる。

5. クライアント データセットが AfterGetRecords イベントを受信。ここでは、プロバイダの AfterGetRecords イベント ハンドラから返されたカスタム情報に応答することができる。

BeforeGetRecords は、Datasnap.DBClient.TRemoteEvent 型です。

関連項目


コード サンプル