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.
// Vide le fichier de données sans le recréer
Client.SupprimeTout()
Syntaxe
<Résultat> = <Source>.SupprimeTout()
<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.
<Source> : Type correspondant à la source spécifiée
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
<Source>.SupprimeTout supprime les enregistrements dans la source de la requête.
Suppression des enregistrements d'une vue HFSQL
La fonction
<Source>.SupprimeTout 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
<Source>.SupprimeTout 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
<Source>.Supprime). Par exemple :
POUR TOUT NumCli DE Commande
Commande.Supprime()
FIN
L'utilisation de la fonction
<Source>.SupprimeTout 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 <Source>.Création
Pour supprimer les enregistrements d'un fichier de données, il est également possible d'utiliser la fonction
<Source>.Création.
L'utilisation de la fonction <Source>.SupprimeTout 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.