Collect-, Clear- och ClearCollect-funktioner i PowerAppsCollect, Clear, and ClearCollect functions in PowerApps

Skapar och rensar samlingar och lägger till poster till alla datakällor.Creates and clears collections and adds records to any data source.

BeskrivningDescription

CollectCollect

Collect-funktionen lägger till poster till en datakälla.The Collect function adds records to a data source. Objekt som kan läggas till kan vara:The items to be added can be:

  • Ett enstaka värde: värdet placeras i fältet Värde i en ny post.A single value: The value is placed in the Value field of a new record. Alla andra egenskaper lämnas tomma.All other properties are left blank.
  • En post: varje namngiven egenskap placeras i motsvarande egenskap hos en ny post.A record: Each named property is placed in the corresponding property of a new record. Alla andra egenskaper lämnas tomma.All other properties are left blank.
  • En tabell: varje post i tabellen läggs till som en separat post hos datakällan enligt beskrivningen ovan.A table: Each record of the table is added as a separate record of the data source as described above. Tabellen läggs inte till som en kapslad tabell i en post.The table is not added as a nested table to a record. För att åstadkomma detta packar du först in tabellen i en post.To accomplish this, wrap the table in a record first.

När den används tillsammans med en samling kan ytterligare kolumner skapas vid behov.When used with a collection, additional columns will be created as needed. Kolumnerna för andra datakällor är fixerade av datakällan och nya kolumner kan inte läggas till.The columns for other data sources are fixed by the data source and new columns cannot be added.

Om datakällan inte redan finns skapas en samling.If the data source doesn't already exist, a collection is created.

Samlingar används ibland för att spara globala variabler eller skapa en tillfällig kopia av en datakälla.Collections are sometimes used to hold global variables or make a temporary copy of a data source. PowerApps baseras på formler som automatiskt omberäknas när användaren interagerar med en app.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Samlingar har inte denna förmån och användningen av dem kan göra din app svårare att skapa och förstå.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Innan du använder en samling i detta sätt kan du granska arbeta med variabler.Before using a collection in this manner, review working with variables.

Du kan också använda korrigeringsfunktionen för att skapa poster i en datakälla.You can also use the Patch function to create records in a data source.

Collect returnerar den modifierade datakällan som en tabell.Collect returns the modified data source as a table. Collect kan bara användas i en beteendeformel.Collect can only be used in a behavior formula.

ClearClear

Clear-funktionen tar bort alla poster i en samling.The Clear function deletes all the records of a collection. Samlingens kolumner finns kvar.The columns of the collection will remain.

Observera att Clear endast fungerar på samlingar och inte andra datakällor.Note that Clear only operates on collections and not other data sources. Du kan använda RemoveIf( DataSource, true ) för detta ändamål.You can use RemoveIf( DataSource, true ) for this purpose. Var försiktig eftersom detta tar bort alla poster från datakällans lagring och det kan påverka andra användare.Use caution as this will remove all records from the data source's storage and can affect other users.

Du kan använda Ta bort-funktionen för att välja vilka poster som ska tas bort.You can use the Remove function to selectively remove records.

Clear har inget returvärde.Clear has no return value. Den kan bara användas i en beteendeformel.It can only be used in a behavior formula.

ClearCollectClearCollect

ClearCollect-funktionen tar bort alla poster från en samling och lägger sedan till en annan uppsättning poster i samma samling.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. Med en enda funktion erbjuder ClearCollect en kombination av Clear och därefter Collect.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect returnerar den modifierade samlingen som en tabell.ClearCollect returns the modified collection as a table. ClearCollect kan bara användas i en beteendeformel.ClearCollect can only be used in a behavior formula.

SyntaxSyntax

Collect( DataSource, Item, ... )Collect( DataSource, Item, ... )

  • DataSource – Krävs.DataSource – Required. Den datakälla som du vill lägga till data i.The data source that you want to add data to. Om den inte redan finns, skapas en ny samling.If it does not already exist, a new collection is created.
  • Item(s) – obligatoriskt.Item(s) - Required. En eller fler poster eller tabeller att lägga till datakällan.One or more records or tables to add to the data source.

Clear( Collection )Clear( Collection )

  • Collection – obligatoriskt.Collection – Required. Den samling som du vill rensa.The collection that you want to clear.

ClearCollect( Collection, Item, ... )ClearCollect( Collection, Item, ... )

  • Collection – obligatoriskt.Collection – Required. Den samling som du vill rensa och därefter lägga till data i.The collection that you want to clear and then add data to.
  • Item(s) – obligatoriskt.Item(s) - Required. En eller fler poster eller tabeller att lägga till datakällan.One or more records or tables to add to the data source.

ExempelExamples

Rensa och lägga till poster till en datakällaClearing and adding records to a data source

I de här exemplen kommer du att radera och lägga till i en samling som heter IceCream.In these examples, you'll erase and add to a collection that's named IceCream. Datakällan börjar med detta innehåll:The data source begins with these contents:

FormelFormula BeskrivningDescription ResultatResult
ClearCollect( IceCream, { Smak: "Jordgubb", Kvantitet: 300 } )ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Tar bort alla data från IceCream-samlingen och lägger sedan till en post som inkluderar en kvantitet jordgubbsglass.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream.

Datakällan IceCream har också modifierats.The IceCream data source has also been modified.
Collect( IceCream, { Smak: "Pistaschmandel", Kvantitet: 40 }, { Smak: "Apelsin", Kvantitet: 200 } )Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Lägger till två poster till IceCream-samlingen som inkluderar en kvantitet pistaschmandel- och apelsinglass.Adds two records to the IceCream collection that includes a quantity of pistachio and Orange ice cream.

Datakällan IceCream har också modifierats.The IceCream data source has also been modified.
Clear( IceCream )Clear( IceCream ) Tar bort alla poster från IceCream-samlingen.Removes all records from the IceCream collection.

Datakällan IceCream har också modifierats.The IceCream data source has also been modified.

Steg för stegStep by step

  1. Lägg till en knapp och ge dess egenskap OnSelect följande funktion:Add a button, and set its OnSelect property to this function:
    Collect(Produkter, "Europa", "Ganymede", "Callisto")Collect(Products, "Europa", "Ganymede", "Callisto")

    Den här funktionen skapar en samling som heter Produkter som innehåller en rad för var och en av tre produktnamn.This function creates a collection that's named Products that contains a row for each of three product names.

  2. Tryck F5, klicka på knappen och tryck sedan på Esc för att återgå till designarbetsytan.Press F5, click the button, and then press the Esc key to return to the design workspace.
  3. (valfritt) För att visa en förhandsgranskning av den samling som du skapade klickar du på Samlingar på fliken Innehåll.(optional) To display a preview of the collection that you created, click Collections on the Content tab.