Die Funktionen „Remove“ und „RemoveIf“

Gilt für: Canvas-Apps Modellgesteuerte Apps Power Platform CLI

Entfernt Datensätze aus einer Datenquelle.

Anmerkung

PAC CLI pac power-fx-Befehle unterstützen die Funktion RemoveIf nicht.

Description

Remove-Funktion

Verwenden Sie die Remove-Funktion, um einen bestimmten Datensatz oder bestimmte Datensätze aus einer Datenquelle zu entfernen.

Für Sammlungen muss der gesamte Datensatz übereinstimmen. Sie können das RemoveFlags.All-Argument verwenden, um alle Kopien eines Datensatzes zu entfernen. Andernfalls wird nur eine Kopie des Datensatzes entfernt.

RemoveIf-Funktion

Verwenden Sie die RemoveIf-Funktion,um einen Datensatz oder Datensätze auf Grundlage einer Bedingung oder eine Reihe von Bedingungen zu entfernen. Jede Bedingung kann jede beliebige Formel sein, die TRUE oder FALSE ergibt, und die auf Spalten der Datenquelle anhand des Namens verweisen kann. Jede Bedingung wird einzeln für jeden Datensatz ausgewertet, und der Eintrag wird entfernt, wenn alle Bedingungen als TRUE ausgewertet werden.

Remove und RemoveIf geben die geänderten Datenquelle als eine Tabelle zurück. Beide Funktionen können nur in Verhaltensformeln geändert werden.

Sie können auch die Clear Funktion verwenden, um alle Datensätze in einer Sammlung zu entfernen.

Stellvertretung

Diese Funktionen können bei Verwendung einer Datenquelle nicht delegiert werden. Nur der erste Teil der Datenquelle wird abgerufen, bevor die Funktion angewendet wird. Dies stellt möglicherweise nicht alles dar. Bei der Dokumenterstellung wird möglicherweise eine Warnung angezeigt, die Sie an diese Einschränkung erinnert.

Delegationsunterstützung (experimentell)

Die Delegationsunterstützung für RemoveIf befindet sich jetzt in der experimentellen Vorschau (standardmäßig AUS) für Datenquellen, die sie unterstützen. Wenn ein Datenquelle diese Funktion nicht unterstützt, sendet Power Apps eine Abfrage an den Server und ruft alle Daten ab, die dem Filterausdruck bis zum Maximum von 500, 2.000 oder der Datenseitengröße entsprechen. Anschließend wird für jeden dieser Datensätze ein Löschvorgang mit einzelnen Aufrufen an den Server durchgeführt.

Syntax

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

  • DataSource – Erforderlich. Die Datenquelle mit den Datensatz bzw. Datensätze, die Sie entfernen möchten.
  • Datensatz – Erforderlich. Der Datensatz oder die Datensätze, die entfernt werden sollen.
  • RemoveFlags.All – optional. In einer Sammlung wird möglicherweise der gleiche Datensatz mehr als einmal angezeigt. Sie können das RemoveFlags.All-Argument hinzufügen, um alle Kopien des Datensatzes zu entfernen.

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

  • DataSource – Erforderlich. Die Datenquelle, die die Datensätze enthält, die Sie entfernen möchten.
  • Tabellee – Erforderlich. Eine Tabelle von zu entfernenden Datensätzen
  • RemoveFlags.All – optional. In einer Sammlung wird möglicherweise der gleiche Datensatz mehr als einmal angezeigt. Sie können das RemoveFlags.All-Argument hinzufügen, um alle Kopien des Datensatzes zu entfernen.

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

  • DataSource – Erforderlich. Die Datenquelle mit den Datensatz bzw. Datensätze, die Sie entfernen möchten.
  • Bedingung(en) - Erforderlich. Eine Formel, die TRUE für die zu ersetzenden Datensätze ergibt. Sie können auch die Spaltennamen aus DataSource in der Formel verwenden. Wenn Sie mehrere Bedingungen angeben, müssen alle für Datensätze oder zu entfernende Datensätze zu TRUE ausgewertet werden.

Beispiele – Einzelformeln

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:

IceCream-Beispiel

Erstellen einer Sammlung mit Beispieldatensätzen

So erstellen Sie eine Sammlung mit diesen Daten:

  1. Fügen Sie ein Button-Steuerelement ein.

  2. Legen Sie die OnSelect-Eigenschaft des button-Steuerelements auf die folgende Formel fest:

    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 aus, während Sie die Alt-Taste gedrückt halten:

Entfernen Sie Beispieldatensätze mithilfe einer Formel aus der Sammlung

Formel Beschreibung Result
Remove( IceCream,
LookUp( IceCream, Flavor="Chocolate" ))
Entfernt den Datensatz Chocolate (Schokolade) aus der Datenquelle Ergebnis mit Vanille und Erdbeere

Die IceCream-Datenquelle wurde geändert.
Remove( IceCream,
LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Strawberry" ) )
Entfernt zwei Datensätze aus der Datenquelle. Ergebnis nur mit Vanille

Die IceCream-Datenquelle wurde geändert.
RemoveIf( IceCream, Quantity > 150 ) Entfernt die Datensätze mit einer Quantity (Menge) größer als 150. Ergebnis nur mit Schokolade

Die IceCream-Datenquelle wurde geändert.
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 beginnt Ergebnis mit Schokolade und Vanille


Die IceCream-Datenquelle wurde geändert.
RemoveIf( IceCream, true ) Entfernt alle Einträge aus der Datenquelle Ergebnis mit ohne Eiscreme

Die IceCream-Datenquelle wurde geändert.

In diesem Beispiel verwenden Sie ein Gallery-Steuerelement, um die Datensätze in einer Tabelle aufzulisten. Dann verwenden Sie die Remove-Funktion, um ein Element gezielt zu entfernen.

Vorbereiten auf Beispieldaten

Dieses Beispiel verwendet die Tabelle Kontakte in Microsoft Dataverse erhältlich mit den Beispiel-Apps und -Daten. Sie können Beispiel-Apps und -Daten bereitstellen, wenn Sie eine Umgebung erstellen. Sie können stattdessen auch ein anderes Datenquelle verwenden.

In diesem Beispiel entfernen Sie ein Element mithilfe einer Schaltfläche außerhalb des Katalogs.

  1. Erstellen Sie eine neue leere Canvas-App mithilfe eines Telefonlayouts.

    Eine neue leere Canvas-App mithilfe des Telefonlayouts

  2. Wählen Sie im linken Bereich die Option Einfügen aus.

  3. Wählen Sie Vertikaler Katalog.
    Ein Gallery-Steuerelement wird Ihrem Bildschirm hinzugefügt.

    Verwenden des Toolbereich „Einfügen“, um ein vertikales gallery-Steuerelement hinzuzufügen

  4. Sie werden aufgefordert, eine Datenquelle auszuwählen, in dem Sie ein Datenquelle aus den verfügbaren Datenquellen auswählen können.
    Wählen Sie beispielsweise die Kontakte Tabelle aus, um Beispieldaten zu verwenden:

    Auswählen der Kontakttabelle zur Anzeige im Katalog

    Der Katalog zeigt Elemente aus dieser Tabelle:

    Katalog mit der Kontakttabelle hinzugefügt

  5. Fügen Sie ein Button-Steuerelement aus dem linken Bereich hinzu:

    Verwenden des Toolbereich „Einfügen“, um ein Schaltflächen-Steuerelement hinzuzufügen

  6. Bewegen Sie die hinzugefügte Schaltfläche unter die Katalogelemente:

    Schaltfläche Verschieben

  7. Aktualisieren Sie die Text-Eigenschaft der Schaltfläche auf Datensatz entfernen. Sie können auch einen Text Ihrer Wahl verwenden:

    Schaltfläche umbenennen

  8. Legen Sie für die OnSelect-Eigenschaft für dieses Schaltflächen-Steuerelement auf die folgende Formel fest:

    Remove( Contacts, Gallery1.Selected )
    

    Festlegen der OnSelect-Eigenschaft des Schaltflächen-Steuerelements

    Das gallery-Steuerelement stellt den aktuell ausgewählten Datensatz mithilfe der Selected-Eigenschaft zur Verfügung. Remove-Funktion bezieht sich auf diesen ausgewählten Datensatz, um ihn zu entfernen.

  9. Starten Sie eine Vorschau der App mit der Abspielen-Schaltfläche oben rechts oder drücken Sie F5 auf der Tastatur:

    Vorschau-App

  10. Wählen Sie einen zu entfernenden Datensatz aus, z. B. Nancy in diesem Beispiel:

    Markieren Sie einen Datensatz.

  11. Wählen Sie Datensatz entfernen aus:

    Katalog der Kontakte, jetzt ohne den Nancy-Datensatz, der entfernt wurde

    Durch Auswahl der Schaltfläche wird der ausgewählte Datensatz entfernt (in diesem Beispiel Nancys Datensatz).

  12. Schließen Sie die Vorschau der App.

    Tipp

    Sie können auch alternatives Verhalten mit Alt-Taste verwenden, anstatt die App-Vorschau mit Abspielen-Schaltfläche oder F5 zu verwenden.

In diesem Beispiel entfernen Sie ein Element mithilfe eines Symbols innerhalb des Katalogs.

Erstellen einer Sammlung mit Beispieldaten

Wenn Sie bereits Beispieldaten vorbereitet haben, überspringen Sie diesen Schritt und gehen Sie zu Papierkorbsymbol in einem Katalog.

  1. Fügen Sie Ihrem Bildschirm ein Button-Steuerelement hinzu.

  2. Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:

    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 aus, während Sie die Alt-Taste gedrückt halten.

Es wird eine Beispielsammlung erstellt, die Sie im folgenden Beispiel verwenden können.

  1. Erstellen Sie eine neue leere Canvas-App mithilfe eines Telefonlayouts.

    Eine neue leere Canvas-App mithilfe des Telefonlayouts

  2. Wählen Sie im linken Bereich die Option Einfügen aus.

  3. Wählen Sie Vertikaler Katalog.
    Ein Gallery-Steuerelement wird Ihrem Bildschirm hinzugefügt.

    Verwenden des Toolbereich „Einfügen“, um ein vertikales gallery-Steuerelement hinzuzufügen

  4. Sie werden aufgefordert, eine Datenquelle auszuwählen, in dem Sie ein Datenquelle aus den verfügbaren Datenquellen auswählen können.
    Wählen Sie beispielsweise die Kontakte Tabelle aus, um Beispieldaten zu verwenden:

    Auswählen der Kontakttabelle zur Anzeige im Katalog

    Wenn Sie eine Sammlung erstellt haben, wählen Sie stattdessen Ihre Sammlung aus:

    Sammlung von Beispielkontakten

  5. Wählen Sie ein Steuerelement innerhalb des obersten Elements im Katalog aus.

    Um sicherzustellen, dass im nächsten Schritt ein Element in die Katalogvorlage und nicht außerhalb des Katalogs eingefügt wird, müssen Sie diesen Schritt ausführen, bevor Sie mit dem nächsten Schritt fortfahren.

    Den besten Datensatz in einem Katalog auswählen

  6. Wählen Sie im linken Bereich Symbol hinzufügen aus.

    Verwenden des Toolbereich „Einfügen“, um ein Symbol-Steuerelement hinzuzufügen

    Notiz

    Symbol hinzufügen fügt ein +-Symbol auf der linken Seite des Katalogs hinzu, as für jedes Element in der Galerie repliziert wird.

  7. Bewegen Sie das Symbol im oberen Bereich auf die rechte Seite des Bildschirms.

    Symbol verschieben

  8. Wählen Sie die Icon-Eigenschaft für das Symbol und setzen Sie es auf die folgende Formel, um das Symbolbild als Papierkorbsymbol zu aktualisieren:

    Icon.Trash
    

    Notiz

    Der Präfix Icon. wird nur angezeigt, wenn Sie die Formel aktiv bearbeiten.

    Ändern des Symbols in das Papierkorbsymbol

  9. Legen Sie die OnSelect-Eigenschaft auf die folgende Formel fest:

    Remove( [@Contacts], ThisItem )
    

    Notiz

    Sie müssen globaler Disambiguierungsoperator[@...] in diesem Beispiel mit Beispieldaten verwenden, die die Kontakte Tabelle verwendet, um Konflikte mit einer Eins-zu-Viele Beziehung zu verwenden. Wenn Sie Datenquellen wie Listen oder eine SQL Server-Tabelle verwenden, ist die Verwendung des globalen Operators zur Mehrdeutigkeitsvermeidung nicht nötig.

    OnSelect für Papiekorbsymbol

  10. Starten Sie eine Vorschau der App mit der Abspielen-Schaltfläche oben rechts oder drücken Sie F5 auf der Tastatur.

  11. Wählen Sie beispielsweise das Papierkorbsymbol neben einem Datensatz aus, z. B. Maria:

    Katalog, bei dem einer der Kontakte entfernt wurde

    Der Datensatz wird gelöscht:

    Datensatz löschen

  12. Schließen Sie die Vorschau der App.