|
|
|
|
|
- Affichage du résultat dans un champ Liste ou Combo
- Extraire une information du résultat
<Source>.ListeClé (Fonction) En anglais : <Source>.ListKey
Non disponible avec ce type de connexion
Renvoie la liste des clés d'un fichier de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL. Il est possible de savoir : - le type de la clé,
- sa taille,
- si la clé est unique ou avec doublons, etc.
Les fichiers définis par les fonctions <Source>.Déclare, <Source>.DéclareExterne et <Source>.DécritFichier sont pris en compte.
ListeCle est une chaîne
ListeCle = Client.ListeClé(hLstDétail)
COMBO_COMBO1.Ajoute(ListeCle)
Syntaxe
<Résultat> = <Source>.ListeClé([<Chemin du WDD> [, <Mot de passe du WDD> [, <Options>]]])
<Résultat> : Chaîne de caractères Liste des clés présentes dans le fichier de données spécifié. Les différentes descriptions de chaque clé sont séparées par RC (Retour chariot). Les clés listées sont triées en fonction de l'ordre physique des clés dans le fichier de données (sauf si la constante hLstTriée est utilisée).En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
| | hLstDétail non précisé | <Nom de la clé 1> + RC + <Nom de la clé 2 + RC + ... Le résultat avec les constantes hLstClé et/ou hLstCléComposée et/ou hLstTriée est identique. | hLstDétail précisé | <Nom de la clé 1> + TAB + <Type> + TAB+ <Taille> + TAB + <Formule> + TAB + <Unique> + TAB + <Libellé> + RC + ... | hLstDétailPlus | <Nom de la clé 1> + TAB + <Type> + TAB + <Taille> + TAB + <Formule> + TAB + <Unique> + TAB + <Libellé> + TAB + <Partie entière des clés numériques> + TAB + <Partie décimale des clés numériques> + RC + ... | Où :- <Nom de clé X> : nom de la clé.
- <Type> : type de la clé : "T" pour texte (et monétaire) ou "N" pour numérique.
- <Taille> : taille de la rubrique.
- <Formule> : formule de la clé si la clé est composée (si la clé est simple, seul le nom de la clé est retourné).
- <Unique> :
- "2" pour les clés primaires.
- "1" pour une clé unique,
- "0" pour une clé avec doublons.
- <Libellé> : libellé de la clé.
- <Partie entière des clés numériques> : nombre de chiffres de la partie entière des clés numériques.
- <Partie décimale des clés numériques> : nombre de chiffres de la partie décimale des clés numériques.
<Source> : Type correspondant à la source spécifiée Nom du fichier de données (de la requête ou de la vue) dont les clés doivent être listées.Si un nom de requête est spécifié, cette requête doit être en cours d'exécution (fonctions <Source>.ExécuteRequête ou <Source>.ExécuteRequêteSQL) pour que la fonction <Source>.ListeClé fonctionne. Dans le cas contraire, une erreur du WLangage est générée. <Chemin du WDD> : Chaîne de caractères optionnelle Chemin complet de l'analyse (c'est-à -dire du fichier .WDD) dans laquelle le fichier de données est décrit. Si ce paramètre n'est pas précisé ou est égal à une chaîne vide (""), le fichier de données est recherché dans l'analyse en cours. <Mot de passe du WDD> : Chaîne de caractères optionnelle Mot de passe défini pour l'analyse. Si aucun mot de passe n'est défini, ce paramètre doit être égal à une chaîne vide (""). <Options> : Constante ou combinaison de constantes de type entier (optionnel) Type de liste à effectuer :
| | hLstClé | Liste les rubriques clés (clés non composées uniquement).
| hLstCléComposée | Liste les rubriques clés composées uniquement.
| hLstDétail | Informations détaillées (idem WINDEV 5.5). | hLstDétailPlus | Pour les clés numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
| hLstNormal (valeur par défaut) | Correspond à hLstTout. Valeur utilisée par défaut si les constantes hLstClé, hLstCléComposée et hLstTout ne sont pas utilisées. | hLstOrdreLogique | Trie la liste dans l'ordre logique des rubriques (ignorée si la constante hLstTriée est précisée).
| hLstRubriqueOrigine | Utilisée sur un fichier journal (xxxJNL.fic), liste les clés du fichier de données original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques clés du fichier CLIENT.
| hLstTout | Liste toutes les clés (hLstClé + hLstCléComposée).
| hLstTriée | Trie la liste par ordre croissant.
|
Remarques Affichage du résultat dans un champ Liste ou Combo <Résultat> peut être directement affecté à un champ Liste ou Combo grâce à la fonction <Liste>.Ajoute. Chaque ligne contiendra le nom d'une des clés trouvées. Extraire une information du résultat Pour extraire une information du résultat détaillé, il est conseillé d'utiliser la fonction <Chaîne ANSI>.ExtraitChaîne.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|