Create entity selection
Create entity selection ( dsTable : Table { ; settings : Object } ) : 4D.EntitySelection
| Paramètres | Type | Description | |
|---|---|---|---|
| dsTable | Table | → | Table de la base 4D dont la sélection courante doit être utilisée pour construire l'entity selection |
| settings | Object | → | Option de création : contexte |
| Résultat | 4D.EntitySelection | ← | Nouvelle entity selection liée à la dataclass de la table |
Historique
| Release | Modifications |
|---|---|
| 17 R5 | Modifié |
| 17 | Created |
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é | Type | Description |
|---|---|---|
| context | Text | Nom du contexte d'optimisation appliqué à l'entity selection. |
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 SELECTIONdataClass.newSelection()
Propriétés
| Numéro de commande | 1512 |
| Thread safe | oui |