PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HEtat (Fonction)
En anglais : HState
HFSQLHFSQL 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é.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 19 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Nouveauté 19
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
SI HEtat(CLIENT) = hEtatActif ALORS
        // Traitements
FIN
Syntaxe
<Résultat> = HEtat([<Nom du fichier> [, <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é.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
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 par 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)
WINDEVWEBDEV - 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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)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 : wd240hf.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire