DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • 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/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
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.
Exemple
// Vide le fichier de données sans le recréer
HSupprimeTout(Client)
Syntaxe
<Résultat> = HSupprimeTout(<Fichier de données>)
<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.
<Fichier de données> : Chaîne de caractères
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 : wd290hf.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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