entitySelection.add( )

4D v19

Descripción

La función entitySelection.add( )agrega la entidad especificada a la selección de entidades y devuelve la selección de entidades modificada.

Nota: este método modifica la selección de entidades original.

Atención: la selección de entidades debe ser no compartible, es decir, que haya sido creada, por ejemplo, por dataClass.newSelection( ) o Create entity selection, de lo contrario entitySelection.add( ) devolverá un error. Las selecciones de entidades compartibles no aceptan la adición de entidades. Para más información, consulte el párrafo Selecciones de entidades compartibles vs. modificables.

La entidad se añade dependiendo de si la selección de entidades está ordenada o no (ver Ordenadas vs No ordenadas) :

Si se ordena la selección de entidades, entidad se agrega al final de la selección. Si una referencia a la misma entidad ya pertenece a la selección de entidades, se duplica y se agrega una nueva referencia.
Si la selección de entidades no está ordenada, entidad se agrega en cualquier parte de la selección, sin un orden específico.

La selección de entidades modificadas es devuelta por la función, de modo que las llamadas a la función pueden ser encadenadas.

Se produce un error si la entidad y la selección de entidades no están relacionadas con la misma dataClass. Si la entidad a agregar es Null, no se genera ningún error.

Ejemplo 1

 var $employee : cs.EmployeeEntity

 var $employees : cs.EmployeeSelection

 

 $employees:=ds.Employee.query("lastName = :1";"S@") //selección de entidades compartibles

 

 $employee:=ds.Employee.new()

 $employee.lastName:="Smith"

 $employee.save()

 

 $employees:=$employees.copy() //Obtener una versión no compartida de la selección de entidades

 $employees.add($employee) //La entidad $employee se añade a la selección de entidades $employees

Ejemplo 2

Las llamadas a la función pueden estar encadenadas:

 var $sel : cs.ProductSelection

 var $p1;$p2;$p3 : cs.ProductEntity

 $p1:=ds.Product.get(10)

 $p2:=ds.Product.get(11)

 $p3:=ds.Product.get(12)

 $sel:=ds.Product.query("ID > 50")

 $sel:=$sel.add($p1).add($p2).add($p3)

Ver también

entitySelection.and( )
entitySelection.drop( )
entitySelection.minus( )