Set functie

Van toepassing op: Canvas-apps Desktop stromen Power Platform CLI Dataverse-functies

Hiermee stelt u de waarde van een globale variabele in.

Samenzicht

Gebruik de Set functie om de waarde van een globale variabele in te stellen, die tijdelijk informatie bevat, zoals het aantal keren dat de gebruiker een knop of het resultaat van een gegevensbewerking heeft geselecteerd.

Globale variabelen zijn in uw app beschikbaar in alle schermen. Dit zijn de meest eenvoudige variabelen, die voldoen voor de meeste situaties. Er zijn ook contextvariabelen die zijn gericht op één scherm en verzameling, die wijzigingen in tabellen op rijniveau mogelijk maken. Meer informatie over deze andere opties vindt u in Variabelen begrijpen.

Power Apps zijn gebaseerd op formules die automatisch opnieuw worden berekend terwijl de gebruiker de app gebruikt. Alle formules die afhankelijk zijn van een variabele, worden automatisch bijgewerkt wanneer deze wijzigt. De variabele wordt echter niet automatisch bijgewerkt als de waarde van de formule die in de Set functie wordt gebruikt, verandert. Dit vereist dat de app-ontwikkelaar de variabele handmatig bijwerkt, wat foutgevoelig kan zijn en moeilijker te begrijpen voor anderen. Raadpleeg Variabelen begrijpen voordat u een variabele gebruikt.

Beschrijving

Globale variabelen worden impliciet gemaakt met behulp van de Set functie. Hiervoor is geen expliciete declaratie vereist. Als u alle Set functies voor een globale variabele verwijdert, blijft die globale variabele bestaan. Als u een variabele wilt wissen, stelt u de waarde ervan in op het resultaat van de functie Blank.

U ziet de waarden, definities en het gebruik van uw variabelen met de weergave Variabelen onder het menu File in Power Apps Studio.

Zoals de voorbeelden verderop in dit onderwerp laten zien, kunnen globale variabelen verschillende soorten informatie bevatten, waaronder de volgende:

• een enkele waarde
• een record
• een tabel
• een verwijzing naar een object
• een resultaat van een formule

Een globale variabele behoudt zijn waarde totdat de app wordt gesloten. Nadat de app is gesloten, gaat de waarde van de globale variabele verloren en moet die opnieuw worden gemaakt wanneer de app wordt geladen.

Globale variabelen kunnen niet dezelfde naam gebruiken als een bestaande verzameling of bestaand besturingselement. Ze kunnen wel dezelfde naam gebruiken als een contextvariabele. Om onderscheid te maken tussen de twee, gebruikt u de Ondubbelzinnigheidsoperator.

Set heeft geen retourwaarde en u kunt deze alleen gebruiken in een gedragsformule.

Syntaxis

Set( VariableName, Value )

• VariabeleNaam - Vereist. De naam van de globale variabele die moet worden gemaakt of bijgewerkt.
• Waarde - Verplicht. De waarde die moet worden toegewezen aan de contextvariabele.

Voorbeelden

Formule	Beschrijving	Resultaat
Set( Teller, 1 )	Hiermee maakt of wijzigt u de globale variabele Teller en stelt u de waarde in op 1.	Teller heeft de waarde 1. U kunt verwijzen naar die variabele door de naam Teller in een formule te gebruiken.
Set( Teller, 2 )	Hiermee stelt u de waarde van de globale variabele Teller uit het vorige voorbeeld in op 2.	Teller heeft de waarde 2.
Set( Teller, Teller + 1 )	Hiermee verhoogt u de waarde van de globale variabele Teller uit het vorige voorbeeld naar 3.	Teller heeft de waarde 3.
Set( Naam, "Lily" )	Hiermee maakt of wijzigt u de globale variabele Naam en stelt u de waarde in op Lily.	Naam heeft de waarde Lily.
Set( Persoon, { Naam: "Milton", Adres: "1 Hoofd st" } )	Hiermee maakt of wijzigt u de globale variabele Persoon en stelt u de waarde in op een record. De record bevat twee kolommen, genaamd Naam en Adres. De waarde van de kolom Naam is Jobse en de waarde van de kolom Adres is Oude Markt 1.	Persoon heeft de waarde van record { Naam: "Milton", Adres: "1 Main St" }. U kunt verwijzen naar deze record in zijn geheel met de naam Persoon of u kunt verwijzen naar een afzonderlijke kolom in deze record met Persoon.Naam of Persoon.Adres.
Set( Persoon, Patch( Persoon, {Adres: "2 Hoofd st" } ) )	Gebruikt de functie Patch om de globale variabele Persoon bij te werken door de waarde van de kolom Adres te wijzigen in Grote Markt 2.	Persoon heeft nu de waarde van record { Naam: "Milton", Adres: "2 Main St" }.