PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Suppression des enregistrements d'une requête
  • Suppression des enregistrements d'une vue HFSQL
  • Suppression des enregistrements dans une transaction
  • Avantage par rapport à un parcours de suppression des enregistrements
  • Avantage par rapport à l'utilisation de la fonction HCréation
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
HSupprimeTout (Fonction)
En anglais : HDeleteAll
ODBCNon disponible avec ce type de connexion
Supprime tous les enregistrements d'un fichier de données, d'une vue HFSQL ou d'une requête. Les enregistrements sont supprimés logiquement et physiquement. Ils ne pourront pas être restaurés.
Les opérations effectuées sont les suivantes :
  • les enregistrements sont supprimés : les enregistrements ne sont plus référencés dans l'index. Les données ne sont pas conservées.
  • les index (correspondant aux clés des enregistrement) sont supprimés du fichier d'index.
  • les mémos associés aux enregistrements sont supprimés du fichier de mémo.
  • les identifiants automatiques sont ré-initialisés.
Attention : l'intégrité n'est pas contrôlée.
WINDEV, WINDEV Mobile et WEBDEV proposent une gestion automatique des erreurs pour les 5 types d'erreur suivants : Erreur de doublons, Erreur d'intégrité, Erreur de mot de passe, Erreur de conflit de modification et d'état lors du conflit de modification, Erreur de blocage. Pour plus de détails, consultez Gestion assistée des erreurs HFSQL.
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.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
AndroidWidget AndroidJava Cette fonction est disponible uniquement pour les fichiers de données ou les requêtes liées à une connexion HFSQL (Classic ou Client/Serveur).
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.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
AndroidWidget AndroidJava Cette fonction est disponible uniquement pour les fichiers de données ou les requêtes liées à une connexion HFSQL (Classic ou Client/Serveur).
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.
Android Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
AndroidWidget AndroidJava Cette fonction est disponible uniquement pour les fichiers de données ou les requêtes liées à une connexion HFSQL (Classic ou Client/Serveur).
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.
Exemple
// Vide le fichier sans le recréer
HSupprimeTout(Client)
Syntaxe
<Résultat> = HSupprimeTout(<Nom du fichier>)
<Résultat> : Booléen
  • Vrai si les enregistrements ont été supprimés,
  • Faux en cas de problème (enregistrement bloqué, enregistrement en transaction, ...). La fonction HErreurInfo permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données HFSQL, de la vue HFSQL ou de la requête manipulé.
Remarques

Suppression des enregistrements d'une requête

Si la requête a été créée en utilisant la constante hModifieFichier, la fonction HSupprimeTout supprime les enregistrements dans la source de la requête.

Suppression des enregistrements d'une vue HFSQL

La fonction HSupprimeTout supprime les enregistrements de la vue mais pas les enregistrements du fichier de données utilisé pour la vue.

Suppression des enregistrements dans une transaction

La fonction HSupprimeTout ne supprime pas les enregistrements présents dans une transaction (annulée ou validée).

Avantage par rapport à un parcours de suppression des enregistrements

Pour supprimer les enregistrements d'un fichier de données, il est également possible de réaliser une boucle de suppression des enregistrements (fonction HSupprime). Par exemple :
POUR TOUT NumCli DE Commande
        HSupprime()
FIN
L'utilisation de la fonction HSupprimeTout présente les avantages suivants :
  • le traitement est plus rapide
  • la taille du fichier de données vide est plus petite.

Avantage par rapport à l'utilisation de la fonction HCréation

Pour supprimer les enregistrements d'un fichier de données, il est également possible d'utiliser la fonction HCréation.
L'utilisation de la fonction HSupprimeTout présente les avantages suivants :
  • Suppression possible même si des utilisateurs sont connectés au fichier de données.
  • Gestion automatique des erreurs HFSQL.
Composante : wd240hf.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire