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 <Source>.ChangeClé 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 <Source>.Lit 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 Client.ChangeClé(Nom) = Faux ALORS
Erreur("Sélectionnez un client dans la table")
FIN
Syntaxe
<Résultat> = <Source>.ChangeClé([<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.
<Source> : Type correspondant à la source spécifiée
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 <Source>.ChangeClé 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 <Source>.Filtre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre.
Rappel : la fonction <Source>.Filtre 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 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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