entitySelection[index]

4D v19.8


entitySelection[index] -> Résultat

Paramètre	Type	Description
Résultat	Entity	Entité correspondant à l'indice spécifié (expression non assignable)

Description

La notation entitySelection[index] vous permet d'accéder aux entités de la sélection d'entités à l'aide de la syntaxe standard des collections : il vous suffit de passer la position de l'entité à laquelle vous souhaitez accéder dans le paramètre index.

A noter que l'entité correspondante est rechargée du datastore.

index peut être tout nombre entre 0 et entitySelection.length-1.

Si index est en-dehors de ces limites, une erreur est retournée.
Si index correspond à une entité supprimée, une valeur Null est retournée.

Attention : entitySelection[index] est une expression non assignable, ce qui signifie qu'elle ne peut pas être utilisée comme référence modifiable de l'entité avec des méthodes telles que entity.lock( ) ou entity.save( ). Pour travailler avec l'entité correspondante, vous devez assigner l'expression retournée à une expression assignable, comme une variable. Exemples :

 $sel:=ds.Employee.all() //création de la sélection d'entités

  //instructions invalides :

 $result:=$sel[0].lock() //INCORRECT - ne fonctionnera pas

 $sel[0].lastName:="Smith" //INCORRECT - ne fonctionnera pas

 $result:=$sel[0].save() //INCORRECT - ne fonctionnera pas

  //code valide :

 $entity:=$sel[0]  //OK

 $entity.lastName:="Smith" //OK

 $entity.save() //OK

Exemple

 C_OBJET($employees;$employee)

 $employees:=ds.Employee.query("lastName = :1";"H@")

 $employee:=$employees[2]  // La 3e entité de la sélection d'entités $employees est chargée depuis la base

Voir aussi

entity.reload( )
entitySelection.first( )