entitySelection.query( )

4D v19.8


entitySelection.query ( queryString \| formula {; value}{; value2 ; ... ; valueN}{; querySettings}) -> Résultat

Paramètre	Type	Description
queryString \| formula	Texte, Objet	Critères de recherche
value	Varié	Valeur(s) à comparer lors de l'utilisation de texte exemple (place holder)
querySettings	Objet	Options de recherche
Résultat	EntitySelection	Nouvelle sélection d'entités composée d'entités issues de la sélection d'entités répondant aux critères de recherche spécifiés dans queryString

Description

La méthode entitySelection.query( ) recherche les entités répondant aux critères de recherche spécifiés dans queryString ou dans formule et (optionnellement) dans value et querySettings parmi toutes les entités de la sélection, et renvoie un nouvel objet de type EntitySelection contenant toutes les entités trouvées. Le mode lazy loading est appliqué.

Note : Cette méthode ne modifie pas la sélection d'entités d'origine.

Si aucune entité correspondante n'est trouvée, une EntitySelection vide est retournée.

Pour plus d'informations sur la génération d'une requête à l'aide des paramètres queryString, value, et querySettings, reportez-vous à la description de la méthode dataClass.query( ).

Note : Par défaut, si vous omettez l'ordre des déclaration dans queryString, la sélection d'entités retournée n'est pas ordonnée (pour plus d'informations, veuillez vous référer à Sélections d'entités triées vs Sélections d'entités non-triées). Notez cependant qu'en mode Client/Serveur, elle se comporte comme une sélection d'entités ordonnée (les entités sont ajoutées à la fin de la sélection).

Exemple 1

 C_OBJECT($entitySelectionTemp)

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

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

Exemple 2

Plus d'exemples de requêtes peuvent être trouvés dans la page dataClass.query( ).

Voir aussi

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