La méthode collection.query( ) retourne tous les éléments de la collection d'objets répondant au(x) critère(s) de recherche définis dans le paramètre chaîneRecherche et, le cas échéant, valeur et params.
Si la collection d'origine est une collection partagée, la collection retournée est également une collection partagée.
Note : Cette méthode ne modifie pas la collection d'origine.
La syntaxe du paramètre chaîneRecherche doit être la suivante :
cheminPropriété comparateur valeur {opérateurLogique cheminPropriété comparateur valeur}
Pour une description détaillée de la construction de recherches à l'aide des paramètres chaîneRecherche, valeur et params, veuillez vous reporter à la description de la méthode dataClass.query( ).
Cet exemple retourne les personnes dont le nom contient "in" :
$col:=$c.query("name = :1";"@in@")
Cet exemple retourne les personnes dont le nom ne débute pas par une certaine valeur, provenant d'une variable (saisie par l'utilisateur, par exemple) :
$col:=$c.query("name # :1";$aString+"@")
Cet exemple retourne les personnes dont l'âge est inconnu (propriété avec valeur null ou propriété indéfinie):
$col:=$c.query("age=null")
Cet exemple retourne les personnes embauchées il y a plus de 90 jours :
$col:=$c.query("dateHired < :1";(Date du jour-90))
Note : Ce dernier exemple nécessite que l'option de compatibilité "Utiliser le type date au lieu du format date ISO dans les objets" soit cochée (cf. Page Compatibilité).
Plus d'exemples de requêtes peuvent être trouvés dans la page dataClass.query( ).