SET QUERY LIMIT
SET QUERY LIMIT ( limite )
Paramètre | Type | Description | |
---|---|---|---|
limite | Integer | → | Nombre limite d'enregistrements ou 0 pour nombre illimité |
Description
La commande SET QUERY LIMIT vous permet d'indiquer à 4D d'arrêter toutes les recherches suivant l'appel de cette commande dans le process courant dès que le nombre d'enregistrements défini dans limite a été atteint.
Si, par exemple, limite est égal à 1, les recherches s'arrêteront dès qu'un enregistrement sera trouvé selon les conditions de la recherche.
Pour que les recherches soient de nouveau sans limite, appelez SET QUERY LIMIT en fixant le paramètre limite à 0.
Attention : SET QUERY LIMIT affecte toutes les recherches dans le process courant. N'oubliez pas d'associer toujours un appel à SET QUERY LIMIT(limite) (lorsque limite>0) à un appel à SET QUERY LIMIT(0) ultérieur pour rétablir les recherches sans limite.
SET QUERY LIMIT modifie uniquement le comportement des commandes de recherche, c'est-à-dire :
- QUERY
- QUERY SELECTION
- QUERY BY EXAMPLE
- QUERY BY FORMULA
- QUERY SELECTION BY FORMULA
- QUERY BY SQL
- QUERY WITH ARRAY
- QUERY SELECTION WITH ARRAY
- QUERY BY ATTRIBUTE
- QUERY SELECTION BY ATTRIBUTE
En revanche, SET QUERY LIMIT n'affecte pas les autres commandes qui modifient la sélection courante d'une table telles que ALL RECORDS, RELATE MANY, etc.
Exemple 1
Pour effectuer une recherche qui correspond à la formule “...trouver dix clients avec lesquels les ventes sont supérieures à 1MF...”, écrivez le code suivant :
SET QUERY LIMIT(10)
QUERY([Clients];[Clients]Ventes>1000000)
SET QUERY LIMIT(0)
Exemple 2
Référez-vous au deuxième exemple de la commande SET QUERY DESTINATION.
Voir aussi
Get query limit
QUERY
QUERY BY EXAMPLE
QUERY BY FORMULA
QUERY BY SQL
QUERY SELECTION
QUERY SELECTION BY FORMULA
QUERY WITH ARRAY
SET QUERY DESTINATION
Propriétés
Numéro de commande | 395 |
Thread safe | ✓ |