Fonctions Remove et RemoveIf dans PowerAppsRemove and RemoveIf functions in PowerApps

Permet de supprimer des enregistrements d’une source de données.Removes records from a data source.

DescriptionDescription

Fonction RemoveRemove function

Utilisez la fonction Remove pour supprimer un ou des enregistrements spécifiques d’une source de données.Use the Remove function to remove a specific record or records from a data source.

Dans les collections, l’enregistrement complet doit correspondre.For collections, the entire record must match. 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.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

Fonction RemoveIfRemoveIf function

Utilisez la fonction RemoveIf pour supprimer un ou des enregistrements d’après une condition ou un ensemble de conditions.Use the RemoveIf function to remove a record or records based on a condition or a set of 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.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Chaque condition est évaluée individuellement pour chaque enregistrement et l’enregistrement est supprimé si toutes les conditions renvoient true.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Les fonctions Remove et RemoveIf renvoient toutes deux la source de données modifiée sous la forme d’une table.Remove and RemoveIf return the modified data source as a table. Utilisez ces deux fonctions ensemble uniquement dans les formules de comportement.You can use both functions only in behavior formulas.

Vous pouvez également utiliser la fonction Clear pour supprimer tous les enregistrements d’une source de données.You can also use the Clear function to remove all of the records in a data source.

DélégationDelegation

When used with a data source, these functions can't be delegated. Only the first portion of the data source will be retrieved and then the function applied. The result may not represent the complete story. A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. For more information, see the delegation overview.

SyntaxeSyntax

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

  • DataSource : requis.DataSource – Required. Source de données contenant l’enregistrement ou les enregistrements à supprimer.The data source that contains the record or records that you want to remove.
  • Record(s) : requis.Record(s) – Required. L’enregistrement ou les enregistrements à supprimer.The record or records to remove.
  • All : facultatif.All – Optional. Dans une collection, le même enregistrement peut apparaître plusieurs fois.In a collection, the same record may appear more than once. Ajoutez l’argument All pour supprimer toutes les copies de l’enregistrement.You can add the All argument to remove all copies of the record.

Remove( DataSource, Table [, All ] )Remove( DataSource, Table [, All ] )

  • DataSource : requis.DataSource – Required. Source de données contenant les enregistrements à supprimer.The data source that contains the records that you want to remove.
  • Table : requis.Table – Required. Table d’enregistrements à supprimer.A table of records to remove.
  • All : facultatif.All – Optional. Dans une collection, le même enregistrement peut apparaître plusieurs fois.In a collection, the same record may appear more than once. Ajoutez l’argument All pour supprimer toutes les copies de l’enregistrement.You can add the All argument to remove all copies of the record.

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

  • DataSource : requis.DataSource – Required. Source de données contenant l’enregistrement ou les enregistrements à supprimer.The data source that contains the record or records that you want to remove.
  • Condition(s) : requis.Condition(s) – Required. Formule renvoyant la valeur true pour l’enregistrement ou les enregistrements à supprimer.A formula that evaluates to true for the record or records to remove. Vous pouvez utiliser les noms de colonne DataSource dans la formule.You can use column names from the DataSource in the formula. Si vous indiquez plusieurs conditions, toutes doivent renvoyer true pour l’enregistrement ou les enregistrements à supprimer.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

ExemplesExamples

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 :In these examples, you'll remove a record or records in a data source that's named IceCream and that starts with the data in this table:

FormuleFormula DescriptionDescription RésultatResult
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Supprime l’enregistrement Chocolate de la source de données.Removes the Chocolate record from the data source.

La source de données IceCream a été modifiée.The IceCream data source has been modified.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Supprime deux enregistrements de la source de données.Removes two records from the data source.

La source de données IceCream a été modifiée.The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150 )RemoveIf( IceCream, Quantity > 150 ) Supprime les enregistrements dont la valeur Quantity est supérieure à 150.Removes records that have a Quantity that's greater than 150.

La source de données IceCream a été modifiée.The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )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.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


La source de données IceCream a été modifiée.The IceCream data source has been modified.
RemoveIf( IceCream, true )RemoveIf( IceCream, true ) Supprime tous les enregistrements de la source de données.Removes all records from the data source.

La source de données IceCream a été modifiée.The IceCream data source has been modified.

Étape par étapeStep by step

  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.Import or create a collection named Inventory, and show it in a gallery as Show data in a gallery describes.
  2. Dans la galerie, définissez la propriété OnSelect de l’image sur l’expression suivante :In the gallery, set the OnSelect property of the image to this expression:
    Remove(Inventory, ThisItem)Remove(Inventory, ThisItem)
  3. Appuyez sur F5, puis sélectionnez une image dans la galerie.Press F5, and then select an image in the gallery.
    L’élément est supprimé de la galerie et de la collection.The item is removed from the gallery and the collection.