DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Numéro d'enregistrement non précisé
  • Fichiers de données au format 5.5
  • Fichiers xBase
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
HEtat (Fonction)
En anglais : HState
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Permet de connaître l'état d'un enregistrement. Un enregistrement peut être actif, rayé ou supprimé.
SI HEtat(Client) = hEtatActif ALORS
// Traitements
FIN
Syntaxe
<Résultat> = HEtat([<Fichier de données> [, <Numéro d'enregistrement>]])
<Résultat> : Constante de type Entier
Etat de l'enregistrement :
hEtatActifL'enregistrement est actif.
hEtatInvalideÉtat de l'enregistrement non trouvé (erreur).
hEtatRayeL'enregistrement est rayé.
hEtatSupL'enregistrement est supprimé.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données utilisé. Si ce nom n'est pas spécifié, la fonction HEtat va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Numéro d'enregistrement> : Entier optionnel
Numéro de l'enregistrement recherché. Si ce numéro n'est pas spécifié (ou est égal à 0), la fonction HEtat va manipuler l'enregistrement en cours. L'enregistrement en cours n'est pas relu.
Remarques

Numéro d'enregistrement non précisé

Si le paramètre <Numéro d'enregistrement> n'est pas précisé, la fonction HEtat ne réalise pas de lecture de l'enregistrement.
Dans une application réseau, il est conseillé de relire l'enregistrement avant l'appel de la fonction HEtat afin de vérifier que l'enregistrement n'a pas été supprimé. Par exemple avec la fonction HLit :
HLit(NomFichier, hNumEnrEnCours)
WEBDEV - Code ServeurHyper File 5.5

Fichiers de données au format 5.5

En utilisant le moteur Hyper File 5, il faut relire l'enregistrement pour avoir un état à jour. En effet, si l'enregistrement n'est pas relu après par exemple les fonctions HSupprime ou HRaye, la fonction HEtat renvoie toujours hEtatActif.
Ce fonctionnement n'est pas préservé dans le moteur HFSQL Classic. Après l'utilisation des fonctions HSupprime ou HRaye sur l'enregistrement en cours, la fonction HEtat renvoie l'état en cours de l'enregistrement.
WEBDEV - Code ServeurAjaxConnecteurs Natifs (Accès Natifs)

Fichiers xBase

La fonction HSupprime a le même effet que la fonction HRaye : l'enregistrement est rayé et non supprimé. L'enregistrement peut donc être réactivé par la fonction HModifie.
Dans ce cas, la fonction HEtat renvoie la constante hEtatRaye sur un enregistrement supprimé (et non la constante hEtatSup).
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/10/2023

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