Aller au contenu principal
Version : 21 R4

Create entity selection

Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection

ParamètresTypeDescription
dsTableTable→Table de la base 4D dont la sélection courante doit être utilisée pour construire l'entity selection
settingsObject→Option de création : contexte
Résultat4D.EntitySelection←Nouvelle entity selection liée à la dataclass de la table
Historique
ReleaseModifications
17 R5Modifié
17Created

Description​

La commande Create entity selection construit et renvoie une nouvelle entity selection modifiable relative à la classe de données correspondant à la dsTable fournie, en fonction de la sélection actuelle de cette table.

Si la sélection actuelle est triée, une entity selection triée est créée (l'ordre de la sélection actuelle est conservé). Si la sélection courante n'est pas triée, une entity selection non-triée est créée.

Si la dsTable n'est pas exposée dans ds, une erreur est retournée. Cette commande ne peut pas être utilisée avec un datastore distant.

Dans le paramètre optionnel settings, vous pouvez passer un objet contenant la propriété suivante :

PropriétéTypeDescription
contextTextNom du contexte d'optimisation appliqué à l'entity selection.
info

Pour des raisons de performance, en 4D monoposte et 4D Server, l'entity selection retournée est directement liée à la sélection courante de dsTable (il ne s'agit pas d'une copie). Tant que la sélection courante n'est pas remplacée, les modifications apportées à l'une sont répercutées dans l'autre. Par exemple, REDUCE SELECTION réduit l'entity selection, et .add() appliquée à l'entity selection ajoute l'entité à la sélection courante. Pour obtenir une entity selection indépendante, appelez .copy() sur le résultat :

$es:=Create entity selection([Employee]).copy()

Exemple​

var $employees : cs.EmployeeSelection
ALL RECORDS([Employee])
$employees:=Create entity selection([Employee])
// L'entity selection $employees contient maintenant un ensemble de
// références vers toutes les entités de la dataclass Employee

Voir également​

USE ENTITY SELECTION
dataClass.newSelection()

Propriétés​

Numéro de commande1512
Thread safeoui