Maakt en wist verzamelingen en voegt records toe aan elke gegevensbron.

Beschrijving

Collect

De functie Collect voegt records toe aan een gegevensbron. De volgende items kunnen worden toegevoegd:

  • Een enkele waarde: de waarde wordt geplaatst in het veld Value van een nieuwe record. Alle andere eigenschappen blijven leeg.

  • Een record: elke benoemde eigenschap wordt in de bijbehorende eigenschap van een nieuwe record geplaatst. Alle andere eigenschappen blijven leeg.

  • Een tabel: elke record van de tabel wordt toegevoegd als een afzonderlijke record van de gegevensbron, zoals hierboven beschreven. De tabel wordt niet als een geneste tabel aan een record toegevoegd. Om dit te doen, pakt u de tabel eerst in een record in.

Wanneer gebruikt in combinatie met een verzameling, worden er indien nodig aanvullende kolommen gemaakt. De kolommen voor andere gegevensbronnen worden vastgezet door de gegevensbron en er kunnen geen nieuwe kolommen worden toegevoegd.

Als de gegevensbron nog niet bestaat, wordt er een verzameling gemaakt.

Verzamelingen worden soms gebruikt om globale variabelen te bewaren of een tijdelijke kopie van een gegevensbron te maken. PowerApps zijn gebaseerd op formules die automatisch opnieuw worden berekend terwijl de gebruiker de app gebruikt. Verzamelingen bieden dit voordeel niet en het gebruik ervan kan uw app moeilijker te ontwikkelen en te begrijpen maken. Raadpleeg Werken met variabelen voordat u een collectie op deze manier gebruikt.

U kunt ook de functie Patch gebruiken om records in een gegevensbron te maken.

Collect retourneert de gewijzigde gegevensbron als een tabel. Collect kan alleen worden gebruikt in een gedragsformule.

Clear

De functie Clear verwijdert alle records van een verzameling. De kolommen van de verzameling worden behouden.

Clear werkt alleen bij verzamelingen en niet bij andere gegevensbronnen. U kunt hiervoor RemoveIf( DataSource, true ) gebruiken. Wees voorzichtig met deze formule. Hiermee worden alle records uit de opslag van de gegevensbron verwijderd, wat van invloed kan zijn op andere gebruikers.

U kunt de functie Remove gebruiken om specifieke records te verwijderen.

Clear heeft geen retourwaarde. Het kan alleen worden gebruikt in een gedragsformule.

ClearCollect

De functie ClearCollect verwijdert alle records uit een verzameling en voegt vervolgens een andere set records toe aan dezelfde verzameling. ClearCollect biedt de combinatie van Clear en Collect in één functie.

ClearCollect retourneert de gewijzigde verzameling als een tabel. ClearCollect kan alleen worden gebruikt in een gedragsformule.

Syntaxis

Collect( DataSource, Item, ... )

  • DataSource - vereist. De gegevensbron waaraan u gegevens wilt toevoegen. Als deze nog niet bestaat, wordt er een nieuwe verzameling gemaakt.
  • Item(s) - vereist. Een of meer records of tabellen die u wilt toevoegen aan de gegevensbron.

Clear( Collection )

  • Collection - vereist. De verzameling die u wilt wissen.

ClearCollect( Verzameling, Item, ... )

  • Collection - vereist. De verzameling die u wilt wissen en vervolgens gegevens aan wilt toevoegen.
  • Item(s) - vereist. Een of meer records of tabellen die u wilt toevoegen aan de gegevensbron.

Voorbeelden

Records wissen en toevoegen aan een gegevensbron

In deze voorbeelden gaat u records wissen en toevoegen aan een verzameling met de naam IJs. De gegevensbron begint met deze inhoud:

Formule Beschrijving Resultaat
ClearCollect ( IJs, { Smaak: "Aardbei", Hoeveelheid: 300 } ) Hiermee wist u alle gegevens van de verzameling IJs en voegt u vervolgens een record toe die een hoeveelheid voor aardbeienijs bevat.

De gegevensbron IJs is ook gewijzigd.
Collect( IJs, { Smaak: "Pistache", Hoeveelheid: 40 }, { Smaak: "Sinaasappel", Hoeveelheid: 200 } ) Hiermee worden twee records toegevoegd aan de verzameling IJs die hoeveelheden voor pistache- en sinaasappelijs bevatten.

De gegevensbron IJs is ook gewijzigd.
Clear( IJs ) Hiermee verwijdert u alle records uit de verzameling IJs.

De gegevensbron IJs is ook gewijzigd.

Stap voor stap

  1. Voeg een knop toe en stel de eigenschap OnSelect ervan in op deze functie:
    Collect(Producten, "Europa", "Ganymede", "Callisto")

    Deze functie maakt een verzameling met de naam Producten die een rij bevat voor elk van de drie productnamen.

  2. Druk op F5, klik op de knop en druk op Esc om terug te keren naar de ontwerpwerkruimte.

  3. Optioneel: als u een voorbeeld wilt weergeven van de verzameling die u hebt gemaakt, klikt u op Verzamelingen op het tabblad Inhoud.