DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Condition de sélection
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Avertissement
A partir de la version 20, les vues SQL et les vues matérialisées sont disponibles.
Les vues manipulées par cette fonction correspondent à l'ancien mécanisme des vues. Elles ne correspondent ni aux vues SQL ni aux vues matérialisées.
Exécute une vue créée auparavant (permet par exemple de réactualiser les données de la vue). Si la vue a été créée avec la fonction HCréeVue en utilisant la constante hVueDifférée, il est nécessaire d'utiliser la fonction HExécuteVue pour exécuter la vue.
Rappel : une vue correspond à une image d'un fichier de données à un instant donné. La vue est stockée en mémoire ce qui la rend insensible aux modifications du fichier de données associé. Une vue peut être manipulée comme un fichier de données HFSQL classique.
// Exécute la vue Client34
HExécuteVue(Client34)
Syntaxe
<Résultat> = HExécuteVue(<Vue> [, <Condition de sélection>])
<Résultat> : Booléen
  • Vrai si la vue a été exécutée,
  • Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Vue> : Chaîne de caractères
Nom de la vue à exécuter. Ce nom a été défini grâce à la fonction HCréeVue.
<Condition de sélection> : Chaîne de caractères optionnelle
  • Nouvelle condition de sélection des enregistrements de la vue (<Condition de sélection> remplace la condition spécifiée lors de la création de la vue). Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode.
  • Chaîne vide ("") pour ne pas modifier la condition de sélection.
Remarques

Condition de sélection

La syntaxe générale d'une condition a la forme suivante :
"NomCli>'Dupont' et CodePos=34 ou CodePos=32"
Les opérateurs acceptés sont variables en fonction du type des rubriques utilisées dans la condition :
>Plus grandValable pour tous les types
>=Plus grand ou égalValable pour tous les types
<Plus petitValable pour tous les types
<>DifférentValable pour tous les types
<=Plus petit ou égalValable pour tous les types
]ContientValable pour les types chaîne uniquement
]=Commence parValable pour les types chaîne uniquement
~=Environ égalValable pour les types chaîne uniquement
=Strictement égalValable pour tous les types

Remarques sur la condition de sélection :
  • Les chaînes constantes doivent être encadrées de simples quotes.
  • Si un nom de rubrique est utilisé dans la condition de sélection, il ne doit comporter que des lettres, des chiffres et des caractères soulignés ("_"). Si le nom de rubrique contient d'autres caractères (apostrophe, etc.), le nom de la rubrique doit être entouré de doubles quotes.
    Par exemple : "e_mail@"]'fr'
  • Les comparaisons entre chaînes se font en fonction de la valeur ASCII des caractères et non pas d'une façon lexicographique ('a' > 'Z').
  • Les mémos binaires, les clés composées, et les rubriques indicées ne peuvent pas faire partie d'une condition de sélection.
  • Si une <constante chaîne> contient une simple quote (ou une double quote), il faut faire précéder cette simple quote (ou double quote) par un anti-slash ( \ ).
  • Toutes les rubriques du fichier de données principal peuvent faire partie de la condition (même celles qui ne sont pas des rubriques de la vue).
  • La condition est appliquée à chaque enregistrement virtuel avant de l'inclure dans la vue. Ainsi, il n'est pas possible d'indiquer plusieurs conditions exclusives entre elle pour un même enregistrement (jointure). Par exemple :
    • "Date='1997' et Date='1996'" ne donne aucun résultat.
    • "Date>='1996' et Date<='1997'" donne tous les enregistrements entre 1996 et 1997.
  • Cette condition de sélection peut être une chaîne de caractères au format Ansi ou Unicode.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale