Permet de supprimer des enregistrements d’une source de données.

Description

Fonction Remove

Utilisez la fonction Remove pour supprimer un ou des enregistrements spécifiques d’une source de données.

Dans les collections, l’enregistrement complet doit correspondre. Vous pouvez utiliser l’argument All pour supprimer toutes les copies d’un enregistrement. Dans le cas contraire, une seule copie de l’enregistrement est supprimée.

Fonction RemoveIf

Utilisez la fonction RemoveIf pour supprimer un ou des enregistrements d’après une condition ou un ensemble de conditions. Chaque condition peut être une formule au choix de type true ou false, ainsi qu’elle peut référencer des colonnes de la source de données par nom. Chaque condition est évaluée individuellement pour chaque enregistrement et l’enregistrement est supprimé si toutes les conditions renvoient true.

Les fonctions Remove et RemoveIf renvoient toutes deux la source de données modifiée sous la forme d’une table. Utilisez ces deux fonctions ensemble uniquement dans les formules de comportement.

Vous pouvez également utiliser la fonction Clear pour supprimer tous les enregistrements d’une source de données.

Délégation

Lorsqu’elles sont utilisées avec une source de données, ces fonctions ne peuvent pas être déléguées. Seule la première partie de la source de données est récupérée, puis la fonction est appliquée. Le résultat peut donc être incomplet. Un point bleu apparaît au moment de l’autorisation pour vous rappeler cette limitation et vous suggérer d’utiliser des fonctions équivalentes pouvant être déléguées lorsque vous le pouvez. Pour plus d’informations, consultez la vue d’ensemble des délégations.

Syntaxe

Remove( DataSource, Record1 [, Record2, ... ] [, All ] )

  • *DataSource* : requis. Source de données contenant l’enregistrement ou les enregistrements à supprimer.

  • *Record(s)* : requis. L’enregistrement ou les enregistrements à supprimer.

  • All : facultatif. Dans une collection, le même enregistrement peut apparaître plusieurs fois. Ajoutez l’argument All pour supprimer toutes les copies de l’enregistrement.

Remove( DataSource, Table [, All ] )

  • *DataSource* : requis. Source de données contenant les enregistrements à supprimer.

  • *Table* : requis. Table d’enregistrements à supprimer.

  • All : facultatif. Dans une collection, le même enregistrement peut apparaître plusieurs fois. Ajoutez l’argument All pour supprimer toutes les copies de l’enregistrement.

RemoveIf( DataSource, Condition [, ... ] )

  • *DataSource* : requis. Source de données contenant l’enregistrement ou les enregistrements à supprimer.

  • Condition(s)* : requis. Formule renvoyant la valeur true pour l’enregistrement ou les enregistrements à supprimer. Vous pouvez utiliser les noms de colonne *DataSource dans la formule. Si vous indiquez plusieurs conditions, toutes doivent renvoyer true pour l’enregistrement ou les enregistrements à supprimer.

Exemples

Dans ces exemples, vous allez supprimer un ou plusieurs enregistrements d’une source de données appelée IceCream qui commence par les données de cette table :

Formule Description Résultat
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Supprime l’enregistrement Chocolate de la source de données.

La source de données IceCream a été modifiée.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Supprime deux enregistrements de la source de données.

La source de données IceCream a été modifiée.
RemoveIf( IceCream, Quantity > 150 ) Supprime les enregistrements dont la valeur Quantity est supérieure à 150.

La source de données IceCream a été modifiée.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Supprime les enregistrements dont la valeur Quantity est supérieure à 150 et dont la valeur Flavor commence par un S.


La source de données IceCream a été modifiée.
RemoveIf( IceCream, true ) Supprime tous les enregistrements de la source de données.

La source de données IceCream a été modifiée.

Étape par étape

  1. Importez ou créez une collection appelée Inventory, puis affichez-la dans une galerie comme décrit dans l’article Afficher les données dans une galerie.

  2. Dans la galerie, définissez la propriété OnSelect de l’image sur l’expression suivante :
    Remove(Inventory, ThisItem)

  3. Appuyez sur F5, puis sélectionnez une image dans la galerie.
    L’élément est supprimé de la galerie et de la collection.