Funktionen Set
Gælder for:
Lærredapps Kort Dataverse plugins med lav kode Power Platform CLI
Indstiller værdien af en global variabel.
Oversigt
Brug funktionen Set til at indstille værdien af en global variabel, som midlertidigt indeholder en oplysning, f.eks. det antal gange, brugeren har valgt en knap, eller resultatet af en datahandling.
Globale variabler er tilgængelige i hele appen i alle skærmbilleder. De globale variabler er den enkleste form for variabler og kan bruges i de fleste situationer. Der findes også kontekstafhængige variabler, som kun gælder for et enkelt skærmbillede og samlinger, der tillader ændringer på rækkeniveau i tabeller. Du kan få flere oplysninger om disse andre indstillinger under Forstå variabler .
Power Apps er baseret på formler, der automatisk genberegnes, når brugeren interagerer med en app. Eventuelle formler, der er afhængige af en variabel, opdateres automatisk, når den ændres. Variablen opdateres dog ikke automatisk, hvis værdien af den formel, der bruges i funktionen Set, ændres. Det kræver, at app-forfatteren manuelt opdaterer variablen, hvilket kan være fejlbehæftet og sværere for at andre at forstå. Læs Forstå variabler, inden du bruger en variabel.
Beskrivelse
Globale variabler oprettes implicit med funktionen Set. Der kræves ingen eksplicit erklæring. Hvis du fjerner alle funktioner af typen Set for en global variabel, vil den globale variabel forsvinde. Hvis du vil rydde en variabel, skal du angive dens værdi til resultatet af funktionen Blank.
Du kan få vist værdier, definitioner og brug af dine variabler i visningen Variabler i menuen Filer i Power Apps Studio.
Som vist i eksemplerne senere i dette emne kan kontekstafhængige variabler indeholde flere forskellige typer oplysninger, f.eks.:
- en enkelt værdi
- en post
- en tabel
- en objektreference
- ethvert resultat af en formel
En kontekstafhængig variabel beholder sin værdi, indtil appen lukkes. Når appen lukkes, mister den kontekstafhængige variabel sin værdi, og den skal gendannes, når appen indlæses igen.
Globale variabler kan ikke have det samme navn som en samling eller et kontrolelement, der allerede findes. Den kan have det samme navn som en kontekstafhængig variabel. Du skal bruge tvetydighedsoperatoren for at skelne mellem de to.
Set har ingen returværdi, og du kan kun bruge den i en funktionsformel.
Syntaks
Set( VariableName, Value )
- VariableName – påkrævet. Navnet på en global variabel, der skal oprettes eller opdateres.
- Value – påkrævet. Den værdi, der skal tildeles til den kontekstafhængige variabel.
Eksempler
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Set( Counter, 1 ) | Opretter eller ændrer den globale variabel Counter og indstiller dens værdi til 1. | Counter har værdien 1. Du kan henvise til variablen ved at bruge navnet Counter i en formel i et vilkårligt skærmbillede. |
| Set( Counter, 2 ) | Indstiller værdien af den globale variabel Counter i det forrige eksempel til 2. | Counter har værdien 2. |
| Set( Counter, Counter + 1 ) | Øger værdien af den globale variabel Counter i det forrige eksempel til 3. | Counter har værdien 3. |
| Set( Name, "Lily" ) | Opretter eller ændrer den globale variabel Name og indstiller dens værdi til Lily. | Name har værdien Lily. |
| Set( Person, { Name: "Milton", Address: "1 Main St" } ) | Opretter eller ændrer den globale variabel Person og indstiller dens værdi til en post. Posten indeholder to kolonner med navnet Name og Address. Værdien af kolonnen Name er Milton, og værdien af kolonnen Address er 1 Main St. | Person har værdien af posten { Navn: "Milton", Adresse: "1 Main St" }. Brug navnet Person for at henvise til hele posten, eller brug Person.Name eller Person.Address for at henvise til en enkelt kolonne i posten. |
| Set( Person, Patch( Person, {Address: "2 Main St" } ) ) | Kan bruges sammen med funktionen Patch til at opdatere den globale variabel Person ved at indstille værdien af kolonnen Address til 2 Main St. | Person har nu samme værdi som posten { Navn: "Milton", Adresse: "2 Main St" }. |