Set-funksjon

Gjelder: Lerretsapper Kort Lavkodebaserte Dataverse-programtillegg Power Platform CLI

Angir verdien for en global variabel.

Oversikt

Bruk Set-funksjonen til å angi verdien for en global variabel, som inneholder midlertidig informasjon, for eksempel hvor mange ganger brukeren har valgt en knapp eller resultatet av en dataoperasjon.

Globale variabler er tilgjengelig i hele appen din, i alle skjermbildene. Dette er den enkleste typen variabler og oppfylle behovene i de fleste tilfeller. Det finnes også kontekstvariabler, som er begrenset til ett enkelt skjermbilde, og samlinger som tillater endringer i tabeller på radnivå. Hvis du vil ha mer informasjon om disse andre alternativene, ser du gjennom Forstå variabler.

Power Apps er basert på formler som automatisk beregnes på nytt når brukeren samhandler med en app. Alle formler som er avhengige av en variabel, oppdateres automatisk når den endres. Variabelen oppdateres imidlertid ikke automatisk hvis verdien i formelen som brukes i Set-funksjonen endres. Dette krever at appoppretteren manuelt kan oppdatere variabelen, noe som kan føre til feil og er vanskeligere for andre å forstå. Før du bruker en variabel se gjennom Forstå variabler.

Beskrivelse

Globale variabler opprettes implisitt ved hjelp av Set-funksjonen. Ingen eksplisitt deklarasjon kreves. Hvis du fjerner alle Set-funksjonene for en global variabel, opphører variabelen å eksistere. Angi variabelens verdi som resultatet av Blank-funksjonen for å fjerne variabelen.

Du kan se variablenes verdier, definisjoner og bruk ved hjelp av Variabler-visningen under Fil-menyen i Power Apps Studio.

I eksemplene senere i dette emnet ser du at de globale variablene kan inneholde flere typer informasjon, deriblant disse:

• en enkelt verdi
• en oppføring
• en tabell
• en objektreferanse
• et resultat av en formel

En global variabel inneholder verdien til appen lukkes. Når appen lukkes, går verdien til den globale variabelen tapt, og den må opprettes på nytt når appen er lastet inn på nytt.

Globale variabler kan ikke bruke samme navn som en eksisterende samling eller kontroll. Den kan bruke samme navn som en kontekstvariabel. Du kan du bruke entydighetsoperatoren for å skille mellom de to.

Set har ingen returverdi, og du kan bruke den i en formel for virkemåte.

Syntaks

Set( VariableName, Value )

• VariableName - obligatorisk. Navnet på en global variabel som skal opprettes eller oppdateres.
• Value - obligatorisk. Verdien som skal tilordnes kontekstvariabelen.

Eksempler

Formel	Beskrivelse	Resultat
Set( Counter, 1 )	Oppretter eller endrer den globale variabelen Counter, og angir verdien dens til 1.	Counter har verdien 1. Du kan referere til denne variabelen med navnet Counter i en formel på enhver skjerm.
Set( Counter, 2 )	Angir verdien for den global variabelen Counter fra det forrige eksemplet som 2.	Counter har verdien 2.
Set( Counter, Counter + 1 )	Øker verdien til den global variabelen Counter fra det forrige eksemplet til 3.	Counter har verdien 3.
Set( Name, "Lily" )	Oppretter eller endrer den globale variabelen Name, og angir verdien dens til Lily.	Name har verdien Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )	Oppretter eller endrer den globale variabelen Person, og angir verdien dens som en post. Posten inneholder to kolonner, kalt Name og Address. Verdien til Name-kolonnen er Milton, og verdien til Address-kolonnen er 1 Main St.	Person har verdien for posten { Name: "Milton", Address: "1 Main St" }. Du kan referere til denne posten som helhet med navnet Person eller referer til en individuell kolonne for denne posten med Person.Name eller Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	Fungerer med Patch-funksjonen for å oppdatere den globale variabelen Person ved å angi verdien til Address-kolonnen som 2 Main St.	Person har nå posten { Name: "Milton", Address: "2 Main St" }.