Die Funktionen „Remove“ und „RemoveIf“ in PowerAppsRemove and RemoveIf functions in PowerApps

Entfernt Datensätze aus einer Datenquelle.Removes records from a data source.

BeschreibungDescription

Remove-FunktionRemove function

Verwenden Sie die Remove-Funktion, um einen bestimmten Datensatz oder bestimmte Datensätze aus einer Datenquelle zu entfernen.Use the Remove function to remove a specific record or records from a data source.

Für Sammlungen muss der gesamte Datensatz übereinstimmen.For collections, the entire record must match. Sie können das All-Argument verwenden, um alle Kopien eines Datensatzes zu entfernen; andernfalls wird nur eine Kopie des Datensatzes entfernt.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

RemoveIf-FunktionRemoveIf function

Verwenden Sie die RemoveIf-Funktion,um einen Datensatz oder Datensätze auf Grundlage einer Bedingung oder eine Reihe von Bedingungen zu entfernen.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Jede Bedingung kann jede beliebige Formel sein, die TRUE oder FALSE ergibt, und die auf Spalten der Datenquelle anhand des Namens verweisen kann.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Jede Bedingung wird einzeln für jeden Datensatz ausgewertet, und der Eintrag wird entfernt, wenn alle Bedingungen als TRUE ausgewertet werden.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Remove und RemoveIf geben die geänderten Datenquelle als eine Tabelle zurück.Remove and RemoveIf return the modified data source as a table. Beide Funktionen können nur in Verhaltensformeln geändert werden.You can use both functions only in behavior formulas.

Sie können auch die Clear Funktion verwenden, um alle Datensätze in einer Datenquelle zu entfernen.You can also use the Clear function to remove all of the records in a data source.

DelegierungDelegation

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.

SyntaxSyntax

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

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle mit den Datensatz bzw. Datensätze, die Sie entfernen möchten.The data source that contains the record or records that you want to remove.
  • Datensatz/Datensätze: erforderlich.Record(s) – Required. Der Datensatz oder die Datensätze, die entfernt werden sollen.The record or records to remove.
  • All: Optional.All – Optional. In einer Sammlung wird möglicherweise der gleiche Datensatz mehr als einmal angezeigt.In a collection, the same record may appear more than once. Sie können das All-Argument hinzufügen, um alle Kopien des Datensatzes zu entfernen.You can add the All argument to remove all copies of the record.

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

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle, die die Datensätze enthält, die Sie entfernen möchten.The data source that contains the records that you want to remove.
  • Tabelle: erforderlich.Table – Required. Eine Tabelle von zu entfernenden DatensätzenA table of records to remove.
  • All: Optional.All – Optional. In einer Sammlung wird möglicherweise der gleiche Datensatz mehr als einmal angezeigt.In a collection, the same record may appear more than once. Sie können das All-Argument hinzufügen, um alle Kopien des Datensatzes zu entfernen.You can add the All argument to remove all copies of the record.

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

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle mit den Datensatz bzw. Datensätze, die Sie entfernen möchten.The data source that contains the record or records that you want to remove.
  • Bedingung(en) : Erforderlich.Condition(s) – Required. Eine Formel, die TRUE für die zu ersetzenden Datensätze ergibt.A formula that evaluates to true for the record or records to remove. Sie können auch die Spaltennamen aus DataSource in der Formel verwenden.You can use column names from the DataSource in the formula. Wenn Sie mehrere Bedingungen angeben, müssen alle für Datensätze oder zu entfernende Datensätze zu TRUE ausgewertet werden.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

BeispieleExamples

In diesen Beispielen entfernen Sie einen Datensatz oder Datensätze aus einer Datenquelle mit dem Namen IceCream (Eiscreme), die mit den Daten in dieser Tabelle beginnt: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:

FormelFormula BeschreibungDescription ErgebnisResult
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Entfernt den Datensatz Chocolate (Schokolade) aus der DatenquelleRemoves the Chocolate record from the data source.

Die Datenquelle IceCream (Eiscreme) wurde geändert.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" ) ) )
Entfernt zwei Datensätze aus der Datenquelle.Removes two records from the data source.

Die Datenquelle IceCream (Eiscreme) wurde geändert.The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150 )RemoveIf( IceCream, Quantity > 150 ) Entfernt die Datensätze mit einer Quantity (Menge) größer als 150.Removes records that have a Quantity that's greater than 150.

Die Datenquelle IceCream (Eiscreme) wurde geändert.The IceCream data source has been modified.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Entfernt die Datensätze mit einer Quantity (Menge) größer als 150 und einem Flavor (Geschmack), der mit S beginntRemoves records that have a Quantity that's greater than 150 and Flavor starts with an S.


Die Datenquelle IceCream (Eiscreme) wurde geändert.The IceCream data source has been modified.
RemoveIf( IceCream, true )RemoveIf( IceCream, true ) Entfernt alle Einträge aus der DatenquelleRemoves all records from the data source.

Die Datenquelle IceCream (Eiscreme) wurde geändert.The IceCream data source has been modified.

Schritt für SchrittStep by step

  1. Importieren oder erstellen Sie eine Sammlung mit dem Namen Inventory (Lagerbestand), und zeigen Sie diese in einem Katalog an, wie unter Show images and text in a gallery, including gallery selection, sort, and filter (Anzeigen von Bildern und Text in einem Katalog, einschließlich Auswählen, Sortieren und Filtern des Katalogs) beschrieben.Import or create a collection named Inventory, and show it in a gallery as Show data in a gallery describes.
  2. Legen Sie im Katalog die OnSelect-Eigenschaft des Bilds auf diesen Ausdruck fest:In the gallery, set the OnSelect property of the image to this expression:
    Remove(Inventory, ThisItem)Remove(Inventory, ThisItem)
  3. Drücken Sie F5, und wählen Sie ein Bild im Katalog.Press F5, and then select an image in the gallery.
    Das Element wird aus dem Katalog und der Sammlung entfernt.The item is removed from the gallery and the collection.