API:Datasnap.DBClient.TClientDataSet.PacketRecords
Delphi
property PacketRecords;
C++
__property PacketRecords = {default=-1};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | published | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TClientDataSet |
説明
単一のデータ パケットに含まれているレコードの数または型を示します。
Datasnap.DBClient.TClientDataSet.PacketRecords は Datasnap.DBClient.TCustomClientDataSet.PacketRecords を継承しています。以下の内容はすべて Datasnap.DBClient.TCustomClientDataSet.PacketRecords を参照しています。
単一のデータ パケットに含まれているレコードの数または型を示します。
PacketRecords を使用すると、プロバイダから取得する単一のパケットに含まれているレコードの数を指定できます。あるいは、返されるパケットにメタデータのみ含まれていることを指定できます。
クライアント データセットがインスタンス化されると、PacketRecords は自動的に -1 に設定されます。つまり、単一のパケットにデータセット内のすべてのレコードが格納されるということです。
PacketRecords が 0 より大きい場合は、パケットに入れて返されるレコードの数を指定します。
データセットのメタデータを取得するには、PacketRecords を 0 に設定します。PacketRecords が 0 の場合、プロバイダは、テーブル、列、制約、定義域の定義など、データベースの構造を定義するデータセット情報のみ返します。
警告: PacketRecords が 0 より大きい場合、クライアント データセットはそのデータをインクリメンタルに取得する必要があります。プロバイダがステートレスなアプリケーション サーバー上にある場合、クライアント データセットはデータの取得を開始する位置をプロバイダに知らせる必要があります。この通信は、BeforeGetRecords イベント ハンドラを使って行うことができます。