USE ENTITY SELECTION
USE ENTITY SELECTION ( entitySelection : 4D.EntitySelection )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| entitySelection | 4D.EntitySelection | → | エンティティセレクション |
説明
The USE ENTITY SELECTION command updates the current selection of the table matching the dataclass of the entitySelection parameter, according to the content of the entity selection.
リモートデータストア の場合は、このコマンドは使用できません。
info
このコマンドは、4Dのカレントセレクションが ORDAクエリの力を活用するためのものです。 パフォーマンス上の理由により、シングルユーザーの 4D と 4D Server では、このコマンドは entitySelection をカレントセレクションと直結します。 そのため、このコマンドに受け渡した entitySelection をその後に再利用したり変更したりすることは避けなければなりません。
注
USE ENTITY SELECTION の呼び出し後、更新された (空でない) カレントセレクションの最初のレコードがカレントレコードとなりますが、それはメモリ内にはロードされません。 カレントレコードのフィールド値を使用するには、USE ENTITY SELECTION コマンドの後に LOAD RECORD コマンドを使用します。
例題
var $entitySel : cs.EmployeeSelection
$entitySel:=ds.Employee.query("lastName = :1";"M@") // $entitySel は Employee データクラスにリレートされています
REDUCE SELECTION([Employee];0)
USE ENTITY SELECTION($entitySel) // Employee テーブルのカレントセレクションが更新されます