entitySelection.add( )

4D v19

Descrição

O método entitySelection.add( )adiciona a entidade especificada à seleção de entidade e devolve a seleção de entidades modificada.

Nota: Este método modifica a seleção de entidade original.

Ateção: a seleção de entidades deve ser não compartilhável, ou seja, que tenha sido criada, por exemplo, por dataClass.newSelection( ) ou Criar seleção de entidade, do contrário entitySelection.add( ) devolverá um erro. As seleções de entidades compartilháveis não aceitam a adição de entidades. Para saber mais, consulte o parágrafo Seleção de Entidade Compatível vs Não-compatível.

A entidade é adicionada dependendo de se a seleção de entidades estiver ordenada ou não (ver Entity selections Ordenadas vs não ordenadas) :

Se a seleção de entidade for ordenada, entidade é adicionada ao final da seleção. Se a referência à mesma entidade já pertencer à entidade de seleção, ela é duplicada e a nova referência é mantida.
Se a seleção de entidade não for ordenada, entidade é adicionada em qualquer parte da seleção, sem ordem específica}.

Nota: Para saber mais, veja o parágrafo Entity selections Ordenadas vs não ordenadas em 4D Developer Guide.

Um erro ocorre se entidade e a seleção de entidades não forem relacionadas à mesma dataClass. Se a entidade a ser adicionada for Null, não se retorna um erro.

Exemplo 1

 var $employee : cs.EmployeeEntity

 var $employees : cs.EmployeeSelection

 

 $employees:=ds.Employee.query("lastName = :1";"S@") //shareable entity selection

 

 $employee:=ds.Employee.new()

 $employee.lastName:="Smith"

 $employee.save()

 

 $employees:=$employees.copy() //Obter uma versão não compartilhada da seleção de entidades

 $employees.add($employee) //A entidade $employee é adicionada à seleção de entidades $employees

Exemplo 2

As chamadas à função podem estar encadeadas:

 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 também

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