funktionen Set

Gælder for: Power Platform CLI Dataverse-funktioner for lærredsapps Desktop

Indstiller værdien af en global variabel.

Oversigt

Brug funktionen Set til at angive værdien af en global variabel, som midlertidigt indeholder oplysninger, 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 Set funktionen, æ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 ved hjælp Set af funktionen . Der kræves ingen eksplicit erklæring. Hvis du fjerner alle Set funktionerne for en global variabel, ophører den globale variabel med at eksistere. 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 formel for funktionsmåde.

Syntaks

Set( VariableName, Value )

• VariableName – Påkrævet. Navnet på en global variabel, der skal oprettes eller opdateres.
• Værdi - Påkrævet. Den værdi, der skal tildeles til den kontekstafhængige variabel.

Eksempler

Formel	Beskrivelse	Resultat
Set( Tæller, 1 )	Opretter eller ændrer den globale variabel Counter og indstiller dens værdi til 1.	Tæller har værdien 1. Du kan henvise til variablen ved at bruge navnet Counter i en formel i et vilkårligt skærmbillede.
Set( Tæller, 2 )	Indstiller værdien af den globale variabel Counter i det forrige eksempel til 2.	Tæller har værdien 2.
Set( Tæller, tæller + 1 )	Øger værdien af den globale variabel Counter i det forrige eksempel til 3.	Tæller har værdien 3.
Set( Navn, "Lily")	Opretter eller ændrer den globale variabel Name og indstiller dens værdi til Lily.	Navn har værdien Lily.
Set( Person, { Navn: "Milton", Adresse: "1 Hovedst" } )	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 værdien af postnavn { : "Milton", Adresse: "2 Main St" }.