entitySelection.query( )

4D v19.8


entitySelection.query ( stringPesq {; valor}{; valor2 ; ... ; valorN}{; configPesq}) -> Resultado

Parâmetro	Tipo	Descrição
stringPesq	Texto, Objeto	Critério de Pesquisa
valor	Mixed	Valores a comparar quando usar placeholders (valores provisórios)
configPesq	Objeto	Opções de Pesquisa: parâmetros, atributos, argumentos, allowFormulas, contexto, rotaPesq, pesqPlano
Resultado	EntitySelection	Nova seleçãoEntidade feita de entidades compsotas da seleção de entidade que correspondem à pesquisa

Descrição

O método entitySelection.query( ) pesquisa por entidades que correspondem aos critérios de pesquisa especificados em stringPesq ou formula e valor (opcionalmente) e opçõesPesq, para todas as entidades na seleção de entidades e retorna um novo objeto de tipo EntitySelection que contém todas as entidades encontradas. Lazy loading (carregamento lento) é aplicado.

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

Se nenhuma entidade correspondente for encontrada, uma EntitySelection vazia é retornada.

Para informações detalhadas sobre como construir uma pesquisa usando os parâmetros stringPesq, valor,e ConfigPesq, veja a descrição do método dataClass.query( ).

Nota: como padrão a sentença order by é omitida na stringPesq, a seleção de entidades retornada não é ordenada (para saber mais veja Entity selections Ordenadas vs não ordenadas). Note entretanto que, no modo Cliente/Servidor, se comporta como uma seleção de entidade ordenada (entidades são adicionadas no final da seleção).

Exemplo 1

 C_OBJECT($entitySelectionTemp)

 $entitySelectionTemp:=dataClass.query("lastName = :1";"M@")

 Form.emps:=$entitySelectionTemp.query("manager.lastName = :1";"S@")

Exemplo 2

Mais exemplos de pesquisas podem ser encontrados em dataClass.query( )

Ver também

collection.query( )
dataClass.query( )
entitySelection.orderBy( )
entitySelection.queryPath
entitySelection.queryPlan