DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
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
Change la rubrique de parcours. L'enregistrement en cours reste inchangé.
Après l'exécution de la fonction, la suite du parcours est réalisée à partir de l'enregistrement en cours, suivant la nouvelle rubrique de parcours. La fonction HChangeClé peut être utilisée par exemple pour amorcer un parcours du fichier de données, après un positionnement sur un enregistrement en accès direct (fonction HLit par exemple).
Remarque : Cette fonction peut être utilisée indifféremment sur un fichier de données, une requête ou une vue HFSQL.
Exemple
// Changement de la clé de parcours
SI HChangeClé(Client, Nom) = Faux ALORS
Erreur("Sélectionnez un client dans la table")
FIN
Syntaxe
<Résultat> = HChangeClé(<Fichier de données> [, <Rubrique> [, <Mode de parcours>]])
<Résultat> : Booléen
  • Vrai si la clé de parcours a été modifiée,
  • Faux en cas de problème (aucune fonction de lecture n'a précédé le changement de clé, ...) : la clé de parcours n'est pas modifiée. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données, de la vue HFSQL ou de la requête manipulé.
<Rubrique> : Chaîne de caractères optionnelle
Nom de la nouvelle rubrique de parcours.
Si ce nom n'est pas spécifié, la fonction HChangeClé va utiliser la dernière rubrique de parcours spécifiée sur ce fichier par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Mode de parcours> : Constante optionnelle de type Entier
Caractéristique du parcours du fichier de données sur la nouvelle clé :
hRespecteFiltreLe parcours prendra en compte le filtre mis en place avec la fonction HFiltre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre.
Rappel : la fonction HFiltre renvoie la clé de parcours optimisée pour le filtre.
Attention : Dans ce cas, sur des fichiers de données de taille importante, des problèmes de performances peuvent survenir.

Hyper File 5.5 Le paramètre <Mode de parcours> ne peut pas être utilisé.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

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