Skapar och rensar samlingar och lägger till poster till alla datakällor.

Beskrivning

Collect

Collect-funktionen lägger till poster till en datakälla. Objekt som kan läggas till kan vara:

  • Ett enstaka värde: värdet placeras i fältet Värde i en ny post. Alla andra egenskaper lämnas tomma.

  • En post: varje namngiven egenskap placeras i motsvarande egenskap hos en ny post. Alla andra egenskaper lämnas tomma.

  • En tabell: varje post i tabellen läggs till som en separat post hos datakällan enligt beskrivningen ovan. Tabellen läggs inte till som en kapslad tabell i en post. För att åstadkomma detta packar du först in tabellen i en post.

När den används tillsammans med en samling kan ytterligare kolumner skapas vid behov. Kolumnerna för andra datakällor är fixerade av datakällan och nya kolumner kan inte läggas till.

Om datakällan inte redan finns skapas en samling.

Samlingar används ibland för att spara globala variabler eller skapa en tillfällig kopia av en datakälla. PowerApps baseras på formler som automatiskt omberäknas när användaren interagerar med en 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å. Innan du använder en samling i detta sätt kan du granska arbeta med variabler.

Du kan också använda korrigeringsfunktionen för att skapa poster i en datakälla.

Collect returnerar den modifierade datakällan som en tabell. Collect kan bara användas i en beteendeformel.

Clear

Clear-funktionen tar bort alla poster i en samling. Samlingens kolumner finns kvar.

Observera att Clear endast fungerar på samlingar och inte andra datakällor. Du kan använda RemoveIf( DataSource, true ) för detta ändamål. Var försiktig eftersom detta tar bort alla poster från datakällans lagring och det kan påverka andra användare.

Du kan använda Ta bort-funktionen för att välja vilka poster som ska tas bort.

Clear har inget returvärde. Den kan bara användas i en beteendeformel.

ClearCollect

ClearCollect-funktionen tar bort alla poster från en samling och lägger sedan till en annan uppsättning poster i samma samling. Med en enda funktion erbjuder ClearCollect en kombination av Clear och därefter Collect.

ClearCollect returnerar den modifierade samlingen som en tabell. ClearCollect kan bara användas i en beteendeformel.

Syntax

Collect( DataSource, Item, ... )

  • DataSource – Krävs. Den datakälla som du vill lägga till data i. Om den inte redan finns, skapas en ny samling.
  • Item(s) – obligatoriskt. En eller fler poster eller tabeller att lägga till datakällan.

Clear( Collection )

  • Collection – obligatoriskt. Den samling som du vill rensa.

ClearCollect( Collection, Item, ... )

  • Collection – obligatoriskt. Den samling som du vill rensa och därefter lägga till data i.
  • Item(s) – obligatoriskt. En eller fler poster eller tabeller att lägga till datakällan.

Exempel

Rensa och lägga till poster till en datakälla

I de här exemplen kommer du att radera och lägga till i en samling som heter IceCream. Datakällan börjar med detta innehåll:

Formel Beskrivning Resultat
ClearCollect( IceCream, { Smak: "Jordgubb", Kvantitet: 300 } ) Tar bort alla data från IceCream-samlingen och lägger sedan till en post som inkluderar en kvantitet jordgubbsglass.

Datakällan IceCream har också modifierats.
Collect( IceCream, { Smak: "Pistaschmandel", Kvantitet: 40 }, { Smak: "Apelsin", Kvantitet: 200 } ) Lägger till två poster till IceCream-samlingen som inkluderar en kvantitet pistaschmandel- och apelsinglass.

Datakällan IceCream har också modifierats.
Clear( IceCream ) Tar bort alla poster från IceCream-samlingen.

Datakällan IceCream har också modifierats.

Steg för steg

  1. Lägg till en knapp och ge dess egenskap OnSelect följande funktion:
    Collect(Produkter, "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.

  2. Tryck F5, klicka på knappen och tryck sedan på Esc för att återgå till designarbetsytan.

  3. (valfritt) För att visa en förhandsgranskning av den samling som du skapade klickar du på Samlingar på fliken Innehåll.