|
|
|
|
|
|
|
|
|
|
HExécuteVue (Fonction) En anglais : HExecuteView
 Non disponible avec ce type de connexion
 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.
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 grand | Valable pour tous les types | | >= | Plus grand ou égal | Valable pour tous les types | | < | Plus petit | Valable pour tous les types | | <> | Différent | Valable pour tous les types | | <= | Plus petit ou égal | Valable pour tous les types | | ] | Contient | Valable pour les types chaîne uniquement | | ]= | Commence par | Valable pour les types chaîne uniquement | | ~= | Environ égal | Valable pour les types chaîne uniquement | | = | Strictement égal | Valable 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|