Collect-, Clear- und ClearCollect-Funktionen in PowerAppsCollect, Clear, and ClearCollect functions in PowerApps

Erstellt und löscht Sammlungen und fügt Datensätze zu einer beliebigen Datenquelle hinzu.Creates and clears collections and adds records to any data source.

BeschreibungDescription

CollectCollect

Die Collect-Funktion fügt Datensätze zu einer Datenquelle hinzu.The Collect function adds records to a data source. Die hinzuzufügenden Elemente können sein:The items to be added can be:

  • Ein einzelner Wert: Der Wert befindet sich im Wert-Feld eines neuen Datensatzes.A single value: The value is placed in the Value field of a new record. Alle anderen Eigenschaften bleiben leer.All other properties are left blank.
  • Ein Datensatz: Jede benannte Eigenschaft wird in der entsprechenden Eigenschaft des neuen Datensatzes eingefügt.A record: Each named property is placed in the corresponding property of a new record. Alle anderen Eigenschaften bleiben leer.All other properties are left blank.
  • Ein Tabelle: Jeder Datensatz der Tabelle wird als ein separater Datensatz der Datenquelle hinzugefügt, wie oben beschrieben.A table: Each record of the table is added as a separate record of the data source as described above. Die Tabelle wird nicht als geschachtelte Tabelle zu einen Datensatz hinzugefügt.The table is not added as a nested table to a record. Umschließen Sie zu diesem Zweck zuerst die Tabelle in einem Datensatz.To accomplish this, wrap the table in a record first.

Bei Verwendung mit einer Sammlung werden bei Bedarf zusätzliche Spalten erstellt.When used with a collection, additional columns will be created as needed. Die Spalten für andere Datenquellen werden von der Datenquelle vordefiniert, und neue Spalten können nicht hinzugefügt werden.The columns for other data sources are fixed by the data source and new columns cannot be added.

Wenn die Datenquelle nicht bereits vorhanden ist, wird eine Sammlung erstellt.If the data source doesn't already exist, a collection is created.

Sammlungen werden manchmal verwendet, um globale Variablen zu halten oder eine temporäre Kopie einer Datenquelle zu erstellen.Collections are sometimes used to hold global variables or make a temporary copy of a data source. PowerApps basiert auf Formeln, die automatisch neu berechnet werden, während der Benutzer mit einer App interagiert.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Sammlungen haben diesen Vorteil nicht und ihre Verwendung kann das Erstellen und Verstehen Ihrer App erschweren.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Lesen Sie vor dem Verwenden einer Sammlung auf diese Weise Working with Variables (Mit Variablen arbeiten).Before using a collection in this manner, review working with variables.

Sie können auch die Patch-Funktion für die Erstellung von Datensätzen in einer Datenquelle verwenden.You can also use the Patch function to create records in a data source.

Collect gibt die geänderte Datenquelle als Tabelle zurück.Collect returns the modified data source as a table. Collect kann nur in einer behavior formula (Verhaltensformel) verwendet werden.Collect can only be used in a behavior formula.

ClearClear

Die Clear-Funktion löscht alle Datensätze einer Sammlung.The Clear function deletes all the records of a collection. Die Spalten der Sammlung bleiben erhalten.The columns of the collection will remain.

Beachten Sie, dass Clear nur bei Sammlungen und nicht bei anderen Datenquellen angewendet wird.Note that Clear only operates on collections and not other data sources. Für diesen Zweck können Sie RemoveIf( DataSource, TRUE) verwenden.You can use RemoveIf( DataSource, true ) for this purpose. Seien Sie vorsichtig, da dies alle Datensätze aus dem Speicher der Datenquelle entfernt und Auswirkungen auf andere Benutzer haben kann.Use caution as this will remove all records from the data source's storage and can affect other users.

Sie können die Remove-Funktion verwenden, um Datensätze gezielt zu entfernen.You can use the Remove function to selectively remove records.

Clear hat keinen Rückgabewert.Clear has no return value. Es kann nur in einer Verhaltensformel verwendet werden.It can only be used in a behavior formula.

ClearCollectClearCollect

Die ClearCollect-Funktion löscht alle Datensätze aus einer Sammlung und fügt anschließend ein anderes Set von Datensätzen zur selben Sammlung hinzu.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. Mit einer einzelnen Funktion bietet ClearCollect die Kombination von Clear und anschließend Collect.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect gibt die geänderte Sammlung als Tabelle zurück.ClearCollect returns the modified collection as a table. ClearCollect kann nur in einer Verhaltensformel verwendet werden.ClearCollect can only be used in a behavior formula.

SyntaxSyntax

Collect( Datenquelle, Element, ... )Collect( DataSource, Item, ... )

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle, in die Sie Daten hinzufügen möchten.The data source that you want to add data to. Wenn nicht bereits vorhanden, wird eine neue Sammlung erstellt.If it does not already exist, a new collection is created.
  • Element(e): Erforderlich.Item(s) - Required. Eine oder mehrere Datensätze oder Tabellen, die der Datenquelle hinzugefügt werden sollen.One or more records or tables to add to the data source.

Clear( Auflistung )Clear( Collection )

  • Auflistung: Erforderlich.Collection – Required. Die Sammlung, die Sie löschen möchten.The collection that you want to clear.

ClearCollect( Auflistung, Element, ... )ClearCollect( Collection, Item, ... )

  • Auflistung: Erforderlich.Collection – Required. Die Sammlung, die Sie löschen und zu der Sie dann Daten hinzufügen möchten.The collection that you want to clear and then add data to.
  • Element(e): Erforderlich.Item(s) - Required. Eine oder mehrere Datensätze oder Tabellen, die der Datenquelle hinzugefügt werden sollen.One or more records or tables to add to the data source.

BeispieleExamples

Löschen und Hinzufügen von Datensätzen zu einer DatenquelleClearing and adding records to a data source

In diesen Beispielen löschen und fügen Sie Daten zu einer Sammlung mit dem Namen IceCream hinzu.In these examples, you'll erase and add to a collection that's named IceCream. Die Datenquelle beginnt mit dem folgenden Inhalt:The data source begins with these contents:

FormelFormula BeschreibungDescription ErgebnisResult
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Löscht alle Daten aus der Sammlung IceCream, und fügt anschließend einen Datensatz hinzu, der eine Menge von Erdbeereis enthält.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream.

Die Datenquelle IceCream wurde auch geändert.The IceCream data source has also been modified.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Fügt zwei Datensätze zur Sammlung IceCream hinzu, die eine Menge von Pistazien- und Orangeneis enthält.Adds two records to the IceCream collection that includes a quantity of pistachio and Orange ice cream.

Die Datenquelle IceCream wurde auch geändert.The IceCream data source has also been modified.
Clear( IceCream )Clear( IceCream ) Entfernt alle Datensätze aus der Sammlung IceCream.Removes all records from the IceCream collection.

Die Datenquelle IceCream wurde auch geändert.The IceCream data source has also been modified.

Schritt für SchrittStep by step

  1. Fügen Sie eine Schaltfläche hinzu, und legen Sie ihre Eigenschaft OnSelect auf diese Funktion fest:Add a button, and set its OnSelect property to this function:
    Collect(Products, "Europa", "Ganymede", "Callisto")Collect(Products, "Europa", "Ganymede", "Callisto")

    Diese Funktion erstellt eine Sammlung mit dem Namen Produkte, die eine Zeile für jeden der drei Produktnamen enthält.This function creates a collection that's named Products that contains a row for each of three product names.

  2. Drücken Sie F5, klicken Sie auf die Schaltfläche, und drücken Sie anschließend die ESC-Taste für eine Rückkehr zum Designarbeitsbereich.Press F5, click the button, and then press the Esc key to return to the design workspace.
  3. (optional) Um eine Vorschau der Sammlung anzuzeigen, die Sie erstellt haben, klicken Sie in der Registerkarte Inhalt auf Sammlungen.(optional) To display a preview of the collection that you created, click Collections on the Content tab.