Sammeln, löschen und clearcollect-Funktionen in powerappsCollect, Clear, and ClearCollect functions in Power Apps

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 basieren auf Formeln, die automatisch neu berechnet werden, wenn der Benutzer mit einer APP interagiert.Power Apps 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; ... )

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

Beispiel Datenquelle

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. Tabelle mit einem Datensatz Table with one record

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection 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 der icecream -Auflistung zwei Datensätze hinzu, die eine Menge von Pistazie und orangefarbener Eiscreme enthalten.Adds two records to the IceCream collection that includes a quantity of pistachio and orange ice cream. Tabelle mit zwei DatensätzenTable with two records

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection has also been modified.
Clear( IceCream )Clear( IceCream ) Entfernt alle Datensätze aus der Sammlung IceCream.Removes all records from the IceCream collection. leere TabelleEmpty table

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection has also been modified.

Schritt-für-Schritt-Beispiele zum Erstellen einer Sammlung finden Sie unter Erstellen und Aktualisieren einer Sammlung.For step-by-step examples of how to create a collection, see Create and update a collection.

Datensätze und TabellenRecords and tables

In diesen Beispielen wird untersucht, wie Datensatz-und Tabellen Argumente erfasst und clearcollect behandelt werden.These examples examine how record and table arguments to Collect and ClearCollect are handled.

FormelFormula BeschreibungDescription ErgebnisResult
Clearcollect (icecream; { Flavor: "Chocolate"; Menge: 100 }; { Flavor: "Vanille"; Menge: 200 })ClearCollect( IceCream; { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) Löschen Sie alle Daten, und fügen Sie dann der icecream -Auflistung zwei Datensätze hinzu, die eine Menge von Schoko-und Vanille-Eis enthalten.Clear all data and then adds two records to the IceCream collection that includes a quantity of chocolate and vanilla ice cream. Die hinzu zufügenden Datensätze werden als einzelne Argumente der Funktion bereitgestellt.The records to be added are provided as individual arguments to the function. der Sammlung hinzugefügte Schoko-und Vanille DatensätzeChocolate and Vanilla records added to collection

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection has also been modified.
Clearcollect (icecream; Tabelle ({ Flavor: "Chocolate"; Menge: 100 }; { Flavor: "Vanille"; Menge: 200 }))ClearCollect( IceCream; Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) ) Identisch mit dem vorherigen Beispiel, mit dem Unterschied, dass die Datensätze in einer Tabelle kombiniert und durch ein einzelnes Argument übermittelt werden.Same as the previous example except that the records are combined in a table and passed in through a single argument. Der Inhalt der Tabelle wird nach Datensatz extrahiert, bevor Sie der icecream -Auflistung hinzugefügt wird.The contents of the table are extracted record by record before being added to the IceCream collection. der Sammlung hinzugefügte Schoko-und Vanille DatensätzeChocolate and Vanilla records added to collection

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection has also been modified.
Clearcollect (icecream;
{ myfavoriten: Table ({ Flavor: "Chocolate"; Menge: 100 }; { Flavor: "Vanille"; Menge: 200 })})
ClearCollect( IceCream;
{ MyFavorites: Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) } )
Identisch mit dem vorherigen Beispiel, mit der Ausnahme, dass die Tabelle in einem Datensatz umschließt ist.Same as the previous example except that the table is wrapped in a record. Die Datensätze der Tabelle werden nicht extrahiert, und stattdessen wird die gesamte Tabelle als untergeordnete Tabelle des Datensatzes hinzugefügt.The records of the table are not extracted and instead the entire table is added as a sub-table of the record. der Sammlung hinzugefügte Schoko-und Vanille DatensätzeChocolate and Vanilla records added to collection

Die icecream -Auflistung wurde ebenfalls geändert.The IceCream collection has also been modified.