entitySelection.query()

Home

4D v19.8


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

Parameter	Typ	Beschreibung
queryString \| formula	Text, Objekt	Suchkriterium
value	Mixed	Werte zum Vergleichen bei Verwenden von Platzhalter(n)
querySettings	Objekt	Suchoptionen: parameters, attributs, queryPath, queryPlan, context
Funktionsergebnis	EntitySelection	Neue Entity-Selection mit den Entities, für die das in queryString angegebene Suchkriterium passt

Beschreibung

Die Methode entitySelection.query() sucht in allen Entities der Entity-Selection nach Entities, für die das in queryString angegebene Suchkriterium bzw. formula und (optional) value passen, und gibt ein neues Objekt vom Typ EntitySelection mit den gefundenen Entities zurück. Lazy loading wird angewendet.

Hinweis: Diese Methode ändert nicht die ursprüngliche Entity-Selection.

Werden keine passenden Entities gefunden, wird eine leere EntitySelection zurückgegeben.

Weitere Informationen zum Erstellen einer Suche mit den Parametern queryString, value und querySettings finden Sie unter der Methode dataClass.query().

Hinweis: Die zurückgegebene Entity-Selection ist standardmäßig nicht sortiert (weitere Informationen dazu finden Sie unter Sortierte vs unsortierte Entity-Selections). Im Client/Server-Betrieb verhält sie sich jedoch wie eine sortierte Entity-Selection, d.h. Entities werden am Ende der Selection hinzugefügt.

Beispiel 1

 C_OBJECT($entitySelectionTemp)

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

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

Beispiel 2

Weitere Beispiele für Suchläufe finden Sie auf der Seite dataClass.query().

Siehe auch

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