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 .Cré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
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.
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).
Exemple
// 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.
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