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
<Source>.Etat (Fonction)
En anglais : <Source>.State
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é.
Exemple
SI Client.Etat() = hEtatActif ALORS
	// Traitements
FIN
Syntaxe
<Résultat> = <Source>.Etat([<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é.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données utilisé.
<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 <Source>.Etat 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 <Source>.Etat 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 <Source>.Etat afin de vérifier que l'enregistrement n'a pas été supprimé. Par exemple avec la fonction <Source>.Lit :
NomFichier.Lit(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 <Source>.Supprime ou <Source>.Raye, la fonction <Source>.Etat renvoie toujours hEtatActif.
Ce fonctionnement n'est pas préservé dans le moteur HFSQL Classic. Après l'utilisation des fonctions <Source>.Supprime ou <Source>.Raye sur l'enregistrement en cours, la fonction <Source>.Etat renvoie l'état en cours de l'enregistrement.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxConnecteurs Natifs (Accès Natifs)

Fichiers xBase

La fonction <Source>.Supprime a le même effet que la fonction <Source>.Raye : l'enregistrement est rayé et non supprimé. L'enregistrement peut donc être réactivé par la fonction <Source>.Modifie.
Dans ce cas, la fonction <Source>.Etat renvoie la constante hEtatRaye sur un enregistrement supprimé (et non la constante hEtatSup).
Composante : wd300hf.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