Funktioner til indsamling, rydning og ClearCollect i Power-appsCollect, Clear, and ClearCollect functions in Power Apps

Opretter og rydder samlinger og føjer poster til alle typer datakilder.Creates and clears collections and adds records to any data source.

BeskrivelseDescription

CollectCollect

Funktionen Collect føjer poster til en datakilde.The Collect function adds records to a data source. Der kan tilføjes følgende typer elementer:The items to be added can be:

  • En enkelt værdi: Værdien placeres i feltet Value for en ny post.A single value: The value is placed in the Value field of a new record. Alle andre egenskaber er tomme.All other properties are left blank.
  • En post: Hver navngivet egenskab placeres i den tilsvarende egenskab for en ny post.A record: Each named property is placed in the corresponding property of a new record. Alle andre egenskaber er tomme.All other properties are left blank.
  • En tabel: Hver post i tabellen tilføjes som en separat post i datakilden som beskrevet ovenfor.A table: Each record of the table is added as a separate record of the data source as described above. Tabellen tilføjes ikke som en indlejret tabel til en post.The table is not added as a nested table to a record. Det opnås ved først at placere tabellen i en post.To accomplish this, wrap the table in a record first.

Når den bruges med en samling, kan der oprettes yderligere kolonner efter behov.When used with a collection, additional columns will be created as needed. Kolonnerne for andre datakilder er faste for datakilden, og der kan ikke tilføjes nye kolonner.The columns for other data sources are fixed by the data source and new columns cannot be added.

Hvis datakilden ikke allerede findes, oprettes der en samling.If the data source doesn't already exist, a collection is created.

Samlinger bruges nogle gange til globale variabler eller til at oprette en midlertidig kopi af en datakilde.Collections are sometimes used to hold global variables or make a temporary copy of a data source. Power-apps er baseret på formler, der automatisk genberegnes, når brugeren interagerer med en app.Power Apps are based on formulas that automatically recalculate as the user interacts with an app. Samlinger har ikke disse fordele, og hvis du bruger samlinger, kan det gøre det sværere at oprette og forstå din app.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Inden du bruger en samling på denne måde, skal du se arbejde med variabler.Before using a collection in this manner, review working with variables.

Du kan også bruge funktionen Patch til at oprette poster i en datakilde.You can also use the Patch function to create records in a data source.

Collect returnerer den ændrede datakilde som en tabel.Collect returns the modified data source as a table. Collect kan kun bruges i en funktionsformel.Collect can only be used in a behavior formula.

ClearClear

Funktionen Clear sletter alle posterne i en samling.The Clear function deletes all the records of a collection. Kolonnen i samlingen bevares.The columns of the collection will remain.

Vær opmærksom på, at Clear kun kan bruges på samlinger og ikke på datakilder.Note that Clear only operates on collections and not other data sources. Du kan bruge RemoveIf( DataSource; true ) til det formål.You can use RemoveIf( DataSource; true ) for this purpose. Vær forsigtig, da dette vil fjerne alle poster fra datakilden, og det kan påvirke andre brugere.Use caution as this will remove all records from the data source's storage and can affect other users.

Du kan bruge funktionen Remove , hvis du vil fjerne bestemte poster.You can use the Remove function to selectively remove records.

Clear har ikke nogen returværdi.Clear has no return value. Den kan kun bruges i en funktionsformel.It can only be used in a behavior formula.

ClearCollectClearCollect

Funktionen ClearCollect sletter alle poster fra en samling og tilføjer derefter et andet sæt poster til samme samling.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. Funktionen ClearCollect er en kombination af Clear efterfulgt af Collect.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect returnerer den ændrede samling som en tabel.ClearCollect returns the modified collection as a table. ClearCollect kan kun bruges i en funktionsformel.ClearCollect can only be used in a behavior formula.

SyntaksSyntax

Collect( DataSource; Item; ... )Collect( DataSource; Item; ... )

  • DataSource – påkrævet.DataSource – Required. Den datakilde, du vil tilføje data i.The data source that you want to add data to. Hvis samlingen ikke allerede findes, oprettes der en ny.If it does not already exist, a new collection is created.
  • Item(s) – påkrævet.Item(s) - Required. En eller flere poster eller tabeller, du føjer til datakilden.One or more records or tables to add to the data source.

Clear( Collection )Clear( Collection )

  • Collection – påkrævet.Collection – Required. Den samling, du vil rydde.The collection that you want to clear.

ClearCollect( Collection; Item; ... )ClearCollect( Collection; Item; ... )

  • Collection – påkrævet.Collection – Required. Den samling, du vil rydde og derefter føje data til.The collection that you want to clear and then add data to.
  • Item(s) – påkrævet.Item(s) - Required. En eller flere poster eller tabeller, du føjer til datakilden.One or more records or tables to add to the data source.

EksemplerExamples

Sådan rydder du poster fra og føjer poster til en datakildeClearing and adding records to a data source

I disse eksempler skal du rydde poster fra og føje poster til en samling med navnet IceCream.In these examples, you'll erase and add to a collection that's named IceCream. Datakilden har følgende indhold til at starte med:The data source begins with these contents:

Datakilde til eksempel

FormelFormula BeskrivelseDescription ResultatResult
ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } )ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } ) Rydder alle data fra samlingen IceCream og tilføjer derefter de poster, hvor der er angivet en mængde for jordbæris.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream. tabel med én post Table with one record

Icecream -samlingen er også blevet ændret.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øjer to poster til samlingen Icecream , der indeholder antallet af pistacieer og den orange Ice fløde.Adds two records to the IceCream collection that includes a quantity of pistachio and orange ice cream. tabel med to posterTable with two records

Icecream -samlingen er også blevet ændret.The IceCream collection has also been modified.
Clear( IceCream )Clear( IceCream ) Fjerner alle poster fra samlingen IceCream.Removes all records from the IceCream collection. tom tabelEmpty table

Icecream -samlingen er også blevet ændret.The IceCream collection has also been modified.

Du kan finde trinvise eksempler på, hvordan du opretter en samling, under Opret og Opdater en samling.For step-by-step examples of how to create a collection, see Create and update a collection.

Poster og tabellerRecords and tables

I disse eksempler undersøges det, hvordan post-og tabel argumenter til indsamling og ClearCollect håndteres.These examples examine how record and table arguments to Collect and ClearCollect are handled.

FormelFormula BeskrivelseDescription ResultatResult
ClearCollect (IceCream; { Flavor: "chokolade"; antal: 100 }; { Flavor: "Vanilla"; antal: 200 })ClearCollect( IceCream; { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) Ryd alle data, og føj derefter to poster til samlingen Icecream , som omfatter en mængde chokolade og Vanilla Ice fløde.Clear all data and then adds two records to the IceCream collection that includes a quantity of chocolate and vanilla ice cream. De poster, der skal tilføjes, angives som individuelle argumenter for funktionen.The records to be added are provided as individual arguments to the function. chokolade-og Vanilla-poster føjet til samlingsChocolate and Vanilla records added to collection

Icecream -samlingen er også blevet ændret.The IceCream collection has also been modified.
ClearCollect (IceCream; Table ({ Flavor: "chokolade"; antal: 100 }; { Flavor: "Vanilla"; antal: 200 }))ClearCollect( IceCream; Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) ) Det samme som det foregående eksempel med undtagelse af, at posterne er kombineret i en tabel og overføres til gennem et enkelt argument.Same as the previous example except that the records are combined in a table and passed in through a single argument. Indholdet af tabellen udtrækkes med post efter post, før den føjes til samlingen Icecream .The contents of the table are extracted record by record before being added to the IceCream collection. chokolade-og Vanilla-poster føjet til samlingsChocolate and Vanilla records added to collection

Icecream -samlingen er også blevet ændret.The IceCream collection has also been modified.
ClearCollect (IceCream;
{ MyFavorites: Table ({ Flavor: "chokolade"; antal: 100 }; { Flavor: "Vanilla"; antal: 200 })})
ClearCollect( IceCream;
{ MyFavorites: Table( { Flavor: "Chocolate"; Quantity: 100 }; { Flavor: "Vanilla"; Quantity: 200 } ) } )
Det samme som det foregående eksempel med undtagelse af, at tabellen er indpakket i en post.Same as the previous example except that the table is wrapped in a record. Posterne i tabellen udpakkes ikke, og hele tabellen tilføjes i stedet som en undertabel for posten.The records of the table are not extracted and instead the entire table is added as a sub-table of the record. chokolade-og Vanilla-poster føjet til samlingsChocolate and Vanilla records added to collection

Icecream -samlingen er også blevet ændret.The IceCream collection has also been modified.