entitySelection[index]

4D v19.8


entitySelection[index] -> entitySelection[index]

Parâmetro	Tipo	Descrição
entitySelection[index]	Entity	Entidade correspondente ao índice específico (expressão não atribuível)

Descrição

A notação entitySelection[index] lhe permite acessar a entidades dentro da seleção de entidade utilizando a sintaxe de coleção padrão: passe a posição da entidade que deseja obter no parâmetro indice.

Lembre que a entidade correspondente volta a ser carregado desde o armazém de dados.

indice pode ser qualquer número entre 0 e entitySelection.length-1.

Se indice estiver fora de faixa, se devolve um erro.
Se indice corresponder a uma entidade soltada, se devolve um valor Null.

entitySelection[index] é uma expressão não atribuível, o que significa que não pode ser usada como uma referência de entidade editável com métodos como entity.lock( ) ou entity.save( ). Para trabalhar com a entidade correspondente, deve assignar a expressão devolvida a uma expressão atribuível como uma variável. Exemplos:

 $sel:=ds.Employee.all() //criação da entity selection

  //invalid statements:

 $result:=$sel[0].lock() //NAO funcionará

 $sel[0].lastName:="Smith" //NAO funcionará

 $result:=$sel[0].save() //NAO funcionará

  //valid code:

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

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

 $entity.save() //OK

Exemplo

 C_OBJECT($employees;$employee)

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

 $employee:=$employees[2]  // A terceira entidade da seleção de entidade $employees é novamente carregado desde o banco de dados

Ver também

entity.reload( )
entitySelection.first( )