entitySelection.add( )

Página Inicial

4D v18

Manual de linguagem 4D

ORDA - seleção de entidade

entitySelection.add( )

Descrição

O método entitySelection.add( )adiciona a entidade especifica à seleção de entidade.

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

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

 C_OBJECT($employees;$employee)

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

 $employee:=ds.Employee.new()

 $employee.lastName:="Smith"

 $employee.save()

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

Ver também

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