DELETE SELECTION

DELETE SELECTION {( laTable )}

Paramètre	Type		Description
laTable	Table	→	Table de laquelle supprimer la sélection courante ou Table par défaut si ce paramètre est omis

Description

La commande DELETE SELECTION supprime la sélection courante d'enregistrements de laTable. Si la sélection courante est vide, DELETE SELECTION ne fait rien. Après la suppression des enregistrements, la sélection courante est vide. Les enregistrements supprimés pendant une transaction sont verrouillés pour les autres utilisateurs et/ou process jusqu'à ce que la transaction soit validée ou annulée.

Attention : La suppression d'une sélection d'enregistrements est une opération définitive. Elle ne peut être annulée par la suite.

Désélectionner l'option Enregistrement(s) définitivement supprimé(s) dans l'Inspecteur des tables vous permet d'augmenter la vitesse des suppressions lors de l'utilisation de DELETE SELECTION (cf. paragraphe Enregistrement(s) définitivement supprimé(s) dans le manuel Mode Développement).

Exemple 1

L'exemple suivant affiche tous les enregistrements de la table [Personnes] et permet à l'utilisateur de sélectionner ceux qu'il souhaite effacer. L'exemple est en deux parties. La première est la méthode affichant les enregistrements. La seconde est la méthode objet d'un bouton 'Supprimer'. Voici la première méthode :

 ALL RECORDS([Personnes]) // Sélection de tous les enregistrements
 FORM SET OUTPUT([Personnes];"FormSortie") // Définition du formulaire listant les enregistrements
 DISPLAY SELECTION([Personnes]) // Affichage de tous les enregistrements

Voici la méthode objet du bouton Supprimer, apparaissant dans le pied de page du formulaire sortie. La méthode utilise les enregistrements sélectionnés par l'utilisateur (l'ensemble système UserSet) pour effacer la sélection (notez que si l'utilisateur ne sélectionne aucun enregistrement, DELETE SELECTION ne fait rien) :

  // Demander confirmation que l'utilisateur veut réellement supprimer les enregistrements
 CONFIRM("Vous avez sélectionné "+String(Enregistrements dans ensemble("UserSet"))+
 " enregistrements à supprimer."+Char(13)+"Cliquez sur OK pour confirmer l'opération.")
 If(OK=1)
    USE SET("UserSet") // Use l'ensemble défini par l'utilisateur
    DELETE SELECTION([Personnes]) // Supprimer la sélection d'enregistrements
 End if
 ALL RECORDS([Personnes]) // Sélection de tous les enregistrements

Exemple 2

Lorsqu'un DELETE SELECTION rencontre un enregistrement verrouillé, celui-ci n'est pas supprimé. Tous les enregistrements verrouillés sont placés dans un ensemble système nommé LockedSet. Après l'exécution de DELETE SELECTION, vous pouvez tester cet ensemble afin de vérifier si des enregistrements étaient verrouillés. La boucle suivante s'exécutera jusqu'à ce que tous les enregistrements aient été supprimés.

 Repeat // Répéter pour chaque enregistrement verrouillé
    DELETE SELECTION([CetteTable])
    If(Records in set("LockedSet")#0) // Si des enregistrements sont verrouillés
       USE SET("LockedSet") // Sélectionner les enregistrements verrouillés
    End if
 Until(Records in set("LockedSet")=0) // Jusqu'à ce qu'il n'y en ait plus

Voir aussi

DISPLAY SELECTION
MODIFY SELECTION
Présentation des ensembles
TRUNCATE TABLE
Verrouillage d'enregistrements

Propriétés

Numéro de commande	66
Thread safe	✓
Change la sélection courante