Funktionen "Remove" und "removeif" in powerappsRemove and RemoveIf functions in Power Apps

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

Diese Funktionen können bei Verwendung einer Datenquelle nicht delegiert werden.When used with a data source, these functions can't be delegated. Nur der erste Teil der Datenquelle wird abgerufen, bevor die Funktion angewendet wird.Only the first portion of the data source will be retrieved and then the function applied. Das Ergebnis stellt möglicherweise nicht alles dar.The result may not represent the complete story. Bei Erstellungszeit erinnert möglicherweise eine Warnung an diese Einschränkung und schlägt den Wechsel zu delegierbaren Alternativen vor, sofern diese bestehen.A warning may appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Weitere Informationen finden Sie unter Überblick über Delegation.For more information, see the delegation overview.

SyntaxSyntax

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

  • DataSource: 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 ] )

  • DataSource: 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 [; ... ] )

  • DataSource: 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.

Beispiele: einzelne FormelnExamples - single formulas

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:

Erstellen einer Sammlung mit Beispiel DatensätzenCreate a collection with sample records

So erstellen Sie eine Sammlung mit diesen Daten:To create a collection with this data:

  1. Ein Schalt Flächen-Steuerelement einfügen.Insert a Button control.

  2. Legen Sie die onselect -Eigenschaft des Schaltflächen Steuer Elements auf die folgende Formel fest:Set button control's OnSelect property to the below formula:

    ClearCollect( IceCream;
                  { ID: 1; Flavor: "Chocolate";  Quantity: 100 };
                  { ID: 2; Flavor: "Vanilla";    Quantity: 200 };
                  { ID: 3; Flavor: "Strawberry"; Quantity: 300 }
    )
    
  3. Wählen Sie die Schaltfläche, während Sie die Alt-Taste gedrückt halten:Select the button while holding down the Alt key:

Entfernen von Beispiel Datensätzen aus einer Sammlung mithilfe einer FormelRemove sample records from collection using a formula

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.

In diesem Beispiel verwenden Sie ein Katalog- Gallery Steuer Element, um die Datensätze in einer Tabelle aufzulisten.In this example, you'll use a Gallery control to list the records in a table. Und verwenden Sie dann die Remove -Funktion, um ein Element selektiv zu entfernen.And then use the Remove function to selectively remove an item.

Vorbereiten von Beispiel DatenPrepare for sample data

In diesem Beispiel wird die Contacts -Entität in Common Data Service mit den Beispiel-apps und-Datenverwendet.This example uses the Contacts entity in Common Data Service available with the sample apps and data. Sie können Beispiel-apps und-Daten bereitstellen, wenn Sie eine Umgebung erstellen.You can deploy sample apps and data when you create an environment. Sie können stattdessen auch eine beliebige andere Datenquelle verwenden.You can also use any other data source instead.

In diesem Beispiel entfernen Sie ein Element mithilfe einer Schaltfläche außerhalb des Katalogs.In this example, you'll remove an item by using a button that is outside the gallery.

  1. Erstellen Sie eine neue leere Canvas-App mit einem Telefon Layout.Create a new blank canvas app using a Phone layout.

    Eine leere Canvas-APP, die das Telefon Layout verwendet

  2. Wählen Sie den Einfügevorgang im linken Bereich aus.Select the Insert from the left pane.

  3. Wählen Sie vertikalerKatalog aus.Select Vertical gallery.
    Ein Katalog-Steuerelement wird dem Bild Schirm hinzugefügt.A Gallery control is be added to your screen.

    Verwenden des einfügetoolbereichs zum Hinzufügen eines vertikalen Katalog-Steuer Elements

  4. Sie werden aufgefordert, eine Datenquelle auszuwählen, in der Sie eine Datenquelle aus den verfügbaren Datenquellen auswählen können.You're prompted to select a data source where you can select a data source from the available data sources.
    Wählen Sie beispielsweise die Contacts -Entität aus, um Beispiel Datenzu verwenden:For example, select the Contacts entity to use sample data:

    Auswählen der Entität "Kontakte", die im Katalog angezeigt werden soll

    Der Katalog zeigt Elemente aus dieser Entität an:The gallery shows items from this entity:

    Der Katalog wurde mit der Entität "Contacts"

  5. Ein Schalt Flächen-Steuerelement aus dem linken Bereich einfügen:Insert a Button control from left pane:

    Verwenden des einfügetoolbereichs zum Hinzufügen eines Button-Steuer Elements

  6. Verschieben Sie die hinzugefügte Schaltfläche unterhalb der Galerie Elemente:Move the added button below the gallery items:

    Schaltfläche Verschieben

  7. Aktualisieren der Schaltflächen Text-Eigenschaft zum Entfernen des DatensatzesUpdate button text property to Remove record. Sie können auch den gewünschten Text verwenden:You can also use text of your choice:

    Schaltfläche Umbenennen

  8. Legen Sie die onselect -Eigenschaft für dieses Schaltflächen-Steuerelement auf die folgende Formel fest:Set the OnSelect property for this button control to the following formula:

    Remove( Contacts; Gallery1.Selected )
    

    Festlegen der onselect-Eigenschaft des Schaltflächen-Steuer Elements

    Das Katalog-Steuerelement macht den aktuell ausgewählten Datensatz mithilfe der ausgewählten Eigenschaft verfügbar.The gallery control makes the currently selected record available using Selected property. Funktion Entfernen verweist auf diesen ausgewählten Datensatz, um ihn zu entfernen.Remove function refers to this selected record to remove it.

  9. Verwenden Sie oben rechts die Schaltfläche "wieder Gabe ", oder drücken Sie F5 auf der Tastatur, um die APP anzuzeigen:Preview the app using the Play button on the top right, or press F5 on keyboard:

    Vorschau der APP

  10. Wählen Sie einen zu entfernenden Datensatz aus, z. b. den Nancy-Datensatz in diesem Beispiel:Select a record to remove, such as Nancy's record in this example:

    Datensatz auswählen

  11. Wählen Sie Datensatz entfernenaus:Select Remove record:

    Galerie mit Kontakten, jetzt ohne den Nancy-Datensatz, der entfernt wurde

    Wenn Sie auf die Schaltfläche klicken, wird der ausgewählte Datensatz (in diesem Beispiel der Nancy-Datensatz) entfernt.Selecting the button removes the selected record (in this example, Nancy's record).

  12. Schließen Sie die APP-Vorschau.Close the app preview.

    Tipp

    Sie können auch alternatives Verhalten mit ALT-Taste verwenden, anstatt die APP-Vorschau mit der Wiedergabe Schaltfläche oder F5zu verwenden.You can also use alternate behavior with Alt key instead of using the app preview with Play button or F5.

In diesem Beispiel entfernen Sie ein Element, indem Sie ein Symbol in der Galerie verwenden.In this example, you'll remove an item by using an icon placed inside the gallery.

Erstellen einer Sammlung mit Beispiel DatenCreate a collection with sample data

Wenn Sie bereits Beispiel Daten vorbereitethaben, überspringen Sie diesen Schritt, und wechseln Sie in einem Katalog zum Papierkorb Symbol.If you already have prepared sample data, skip this step and move to Trash can icon inside a gallery.

  1. Fügen Sie dem Bildschirm ein Button -Steuerelement hinzu.Add a Button control to your screen.

  2. Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:Set the OnSelect property to the following formula:

    ClearCollect( SampleContacts; 
          { 'Full Name': "Yvonne McKay (sample)";      'Primary Email': "someone_a@example.com" };
          { 'Full Name': "Susanna Stubberod (sample)"; 'Primary Email': "someone_b@example.com" };
          { 'Full Name': "Nancy Anderson (sample)";    'Primary Email': "someone_c@example.com" };
          { 'Full Name': "Maria Campbell (sample)";    'Primary Email': "someone_d@example.com" };
          { 'Full Name': "Robert Lyon (sample)";       'Primary Email': "someone_e@example.com" };
          { 'Full Name': "Paul Cannon (sample)";       'Primary Email': "someone_f@example.com" };
          { 'Full Name': "Rene Valdes (sample)";       'Primary Email': "someone_g@example.com" } 
    )
    
  3. Wählen Sie die Schaltfläche, während Sie die Alt-Taste gedrückt halten.Select the button while holding down the Alt key.

Die Beispiel Sammlung wird erstellt, die Sie im folgenden Beispiel verwenden können.Sample collection is created that you can use in the following example.

  1. Erstellen Sie eine neue leere Canvas-App mit einem Telefon Layout.Create a new blank canvas app using a Phone layout.

    Eine leere Canvas-APP, die das Telefon Layout verwendet

  2. Wählen Sie den Einfügevorgang im linken Bereich aus.Select the Insert from the left pane.

  3. Wählen Sie vertikalerKatalog aus.Select Vertical gallery.
    Ein Katalog-Steuerelement wird dem Bild Schirm hinzugefügt.A Gallery control is be added to your screen.

    Verwenden des einfügetoolbereichs zum Hinzufügen eines vertikalen Katalog-Steuer Elements

  4. Sie werden aufgefordert, eine Datenquelle auszuwählen, in der Sie eine Datenquelle aus den verfügbaren Datenquellen auswählen können.You're prompted to select a data source where you can select a data source from the available data sources.
    Wählen Sie beispielsweise die Contacts -Entität aus, um Beispiel Datenzu verwenden:For example, select the Contacts entity to use sample data:

    Auswählen der Entität "Kontakte", die im Katalog angezeigt werden soll

    Wenn Sie eine Sammlungerstellt haben, wählen Sie stattdessen Ihre Sammlung aus:If you created a collection, select your collection instead:

    Sammlung von Beispiel Kontakten

  5. Wählen Sie ein Steuerelement im oberen Bereich des Katalogs aus.Select a control within the top item in the gallery.

    Stellen Sie sicher, dass Sie diesen Schritt ausführen, bevor Sie mit dem nächsten Schritt fortfahren, um sicherzustellen, dass der nächste Schritt das Element in der Galerie Vorlage und nicht außerhalb des KatalogsTo ensure next step inserts item into gallery's template and not outside the gallery, ensure you follow this step before moving to the next step.

    Auswählen des obersten Datensatzes in einem Katalog

  6. Wählen Sie im linken Bereich Symbol hinzufügen aus.Select Add icon from left pane.

    Verwenden des einfügetoolbereichs zum Hinzufügen eines Symbol Steuer Elements

    Hinweis

    Symbol "hinzufügen " fügt ein + Symbol auf der linken Seite des Katalogs ein, das für jedes Element im Katalog repliziert wird.Add icon inserts a + icon on the left side of the gallery, replicated for each item in the gallery.

  7. Verschieben Sie das Symbol im oberen Element auf die Rechte Seite des Bildschirms.In the top item, move the icon to the right side of the screen.

    Symbol "Verschieben"

  8. Wählen Sie die Symbol Eigenschaft für Symbol aus, und legen Sie Sie auf die folgende Formel fest, um das Symbolbild als Papierkorb Symbol zu aktualisieren:Select the Icon property for icon and set it to the following formula to update the icon image as trash icon:

    Icon.Trash
    

    Hinweis

    Das Symbol.The Icon. das Präfix wird nur angezeigt, wenn Sie die Formel aktiv bearbeiten.prefix is only shown when you're actively editing the formula.

    Ändern des Symbols in das Papierkorb Symbol

  9. Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:Set the OnSelect property to the following formula:

    Remove( [@Contacts]; ThisItem )
    

    Hinweis

    Sie müssen den globalen mehrdeutigkeits Operator [@ ... ] in diesem Beispiel mit Beispiel Daten, die die Contacts -Entität verwenden, um Konflikte mit einer 1: n- Beziehung zu vermeiden.You must use global disambiguation operator [@...] in this example with sample data that uses the Contacts entity to avoid conflict with a One-to-Many relationship. Wenn Sie Datenquellen wie z. b. eine SharePoint-Liste oder eine SQL Server Tabelle verwenden, ist die Verwendung des globalen disambgulations-Operators nicht erforderlich.If you use data sources such as a SharePoint list or a SQL Server table, using global disambgulation operator is not required.

    Onselect für Papierkorb (Symbol)

  10. Verwenden Sie oben rechts die Schaltfläche wiedergeben, oder drücken Sie F5 , um die app in der Vorschau anzuzeigen.Preview the app using the Play button on the top right, or press F5 on keyboard.

  11. Wählen Sie das Papierkorb Symbol neben einem Datensatz aus, z. b. " Maria":Select the trash icon next to a record, for example Maria's:

    Katalog mit einem der entfernten Kontakte

    Der Datensatz wird gelöscht:The record is deleted:

    Datensatz gelöscht

  12. Schließen Sie die APP-Vorschau.Close the app preview.