Create entity selection

4D v18


Create entity selection ( dsTable {; settings} ) -> 戻り値

引数	型	説明
dsTable	テーブル	エンティティセレクションの元となるカレントセレクションが属する4Dデータベースのテーブル
settings	Object	ビルドオプション: context
戻り値	EntitySelection	指定したテーブルに対応するデータクラスのエンティティセレクション

説明

Create entity selection コマンドは、dsTable 引数で指定したテーブルに対応するデータクラスの新規エンティティセレクションを、同テーブルのカレントセレクションに基づいてビルドして返します。

ソートされたカレントセレクションの場合、順列のあるエンティティセレクションが作成されます (カレントセレクションの並び順が受け継がれます)。カレントセレクションがソートされていない場合、順列のないエンティティセレクションが作成されます。詳細については、4D Developer Guide のエンティティセレクションの順列あり/順列なしの段落を参照ください。

dsTable 引数のテーブルがds に公開されていない場合、エラーが返されます。
利用しているのがリモートデータストアの場合、このコマンドは使用できません。

settings

任意のsettings 引数には、追加のオプションを格納しているオブジェクトを渡すことができます。以下のプロパティがサポートされています:

プロパティ	型	詳細
context	テキスト	エンティティセレクションに適用されている最適化コンテキストのラベル。エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けることができます。この機能はORDA のクライアント/サーバー処理を想定して設計されています。詳細については、クライアント/サーバーの最適化の章を参照ください。

例題

 C_OBJECT($employees)

 ALL RECORDS([Employee])

 $employees:=Create entity selection([Employee])

  // $employees エンティティセレクションには、Employee データクラスの全エンティティへの参照が格納されている

参照

USE ENTITY SELECTION