PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Limitations
  • xBase
  • Nombre d'enregistrements traités par les mises à jour de type INSERT/UPDATE/DELETE
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
HNbEnr (Fonction)
En anglais : HNbRec
ODBCNon disponible avec ce type de connexion
Renvoie le nombre d'enregistrements d'un fichier de données, d'une requête ou d'une vue HFSQL : enregistrements actifs, rayés, supprimés, etc.
Attention : La fonction HNbEnr ne tient pas compte du filtre en cours.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
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
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
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 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.
// Enregistrements actifs du fichier "Client"
NbEnrClient = HNbEnr(Client)
Syntaxe
<Résultat> = HNbEnr([<Nom du fichier> [, <Options>]])
<Résultat> : Entier
  • Nombre d'enregistrements recherchés,
  • -1 en cas d'erreur. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
Accès Natifs Accès Natif XML : le nombre d'enregistrements dépend de l'utilisation des fonctions HActiveFiltreAuto/HDésactiveFiltreAuto :
  • Si le filtrage est actif, seuls les enregistrements appartenant au père courant sont pris en compte.
  • Si le filtrage est non actif, les enregistrements présents dans le fichier XML sont pris en compte.
Par défaut, le filtrage est actif.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données, de la vue HFSQL ou de la requête manipulé. Si ce paramètre n'est pas spécifié, la fonction HNbEnr va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Options> : Constante ou combinaison de constantes optionnelle
Paramètre le type d'enregistrement à compter.
hEtatActif
(valeur par défaut)
Nombre d'enregistrements actifs (non rayés, non supprimés).
hEtatRayéNombre d'enregistrements rayés.
Hyper File 5.5 Cette option n'est pas disponible.
hEtatSupNombre d'enregistrements supprimés (n'inclut pas les enregistrements rayés).
hEtatTousNombre total des enregistrements du fichier de données (hEtatActif + hEtatRaye + hEtatSup).
hNonBloquantNombre d'enregistrements récupérés de la vue ou de la requête sans attendre la fin du remplissage de la vue ou de la requête. Il est possible de savoir si l'exécution de la vue ou de la requête est terminée grâce à la propriété ..ExécutionTerminée.
Cette constante est disponible uniquement pour les vues et les requêtes HFSQL Classic ou Client/Serveur.
Cette constante est sans effet sur les fichiers de données ou pour les accès natifs.
PHPOLE DBAccès Natifs Ce paramètre est ignoré. Le nombre d'enregistrements calculé par la fonction HNbEnr correspond toujours au nombre total d'enregistrements dans la table, sur la base de données.
Ce nombre peut être différent du nombre d'enregistrements affichés si un autre utilisateur a ajouté ou supprimé des enregistrements. Pour visualiser ces nouveaux enregistrements, réinitialisez un parcours en utilisant une des fonctions suivantes : HLitPremier, HLitDernier, HPremier, HDernier.
Java Accès par JDBC
Ce paramètre est ignoré. Le nombre d'enregistrements calculé par la fonction HNbEnr correspond toujours au nombre total d'enregistrements dans la table, sur la base de données.
Ce nombre peut être différent du nombre d'enregistrements affichés si un autre utilisateur a ajouté ou supprimé des enregistrements. Pour visualiser ces nouveaux enregistrements, réinitialisez un parcours en utilisant une des fonctions suivantes : HLitPremier, HLitDernier, HPremier, HDernier.
Remarques

Limitations

  • La fonction HNbEnr ne retourne pas le nombre d'enregistrements modifiés suite à l'exécution d'une requête en modification (UPDATE).
  • La fonction HNbEnr ne fonctionne pas avec les requêtes utilisant la constante hAvecFiltre.
WINDEVWEBDEV - Code ServeurLangage ExterneAccès Natifs

xBase

La fonction HNbEnr utilisée avec la constante hEtatActif ou hEtatTous renvoie également le nombre d'enregistrements rayés (ou supprimés) (compatibilité avec les versions antérieures).
Par contre, il est possible de connaître le nombre d'enregistrements rayés ou supprimés par grâce à la fonction HNbEnr utilisée avec la constante hEtatSup ou hEtatRayé.
Versions 18 et supérieures

Nombre d'enregistrements traités par les mises à jour de type INSERT/UPDATE/DELETE

Lors de l'exécution d'une requête de type INSERT/UPDATE/DELETE sur des fichiers de données HFSQL, il est possible de connaître le nombre d'enregistrements ayant été ajoutés, modifiés ou supprimés grâce à la variable H.NbEnregRequêteModification.
Nouveauté 18

Nombre d'enregistrements traités par les mises à jour de type INSERT/UPDATE/DELETE

Lors de l'exécution d'une requête de type INSERT/UPDATE/DELETE sur des fichiers de données HFSQL, il est possible de connaître le nombre d'enregistrements ayant été ajoutés, modifiés ou supprimés grâce à la variable H.NbEnregRequêteModification.

Nombre d'enregistrements traités par les mises à jour de type INSERT/UPDATE/DELETE

Lors de l'exécution d'une requête de type INSERT/UPDATE/DELETE sur des fichiers de données HFSQL, il est possible de connaître le nombre d'enregistrements ayant été ajoutés, modifiés ou supprimés grâce à la variable H.NbEnregRequêteModification.
Classification Métier / IHM : Code métier
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire