DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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é par exemple) : 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 de données 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 : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 02/12/2024

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