Iestatīt funkciju

Attiecas uz: Audekla programmām Kartes Dataverse zema koda spraudņi Power Platform CLI

Iestata globālā mainīgā vērtību.

Pārskats

Izmantojiet Set funkciju, lai iestatītu globālo mainīgā vērtību, kas īslaicīgi ietver kādu informācijas vienību, piemēram, reižu skaitu, kad lietotājs ir atlasījis pogu, vai datu operācijas rezultātu.

Globālie mainīgie ir pieejami visā programmā visos ekrānos. Tie ir visvienkāršākie mainīgie, un tie nodrošina vajadzības vairumā situāciju. Pastāv arī konteksta mainīgie, kuri tiek ierobežoti līdz vienam ekrānam, un kolekcijas, kas ļauj veikt rindas līmeņa pārveides tabulās. Papildinformāciju par šīm citām opcijām skatiet sadaļā Izprotiet mainīgos.

Power Apps balstās uz formulām, kas tiek automātiski pārrēķinātas, lietotājam mijiedarbojoties ar programmu. Visas formulas, kuras ir atkarīgas no mainīgā, tiks automātiski atjauninātas, tam mainoties. Taču mainīgo automātiski neatjauninās, ja tiek mainīta Set funkcijā izmantotās formulas vērtība. Tam ir nepieciešams, ka programmas veidotājs manuāli atjaunina mainīgo, kas var radīt kļūdas un būt grūtāk izprotami citiem. Pirms mainīgā lietošanas pārskatiet sadaļu Izprotiet mainīgos.

Apraksts

Globālos mainīgos netieši izveido, izmantojot funkciju Set. Nav nepieciešama tieša deklarācija. Ja globālajam mainīgajam noņemat visas Set funkcijas, šis globālais mainīgais vairs nepastāvēs. Lai notīrītu mainīgo, Iestatiet to vērtību uz Blank funkcijas rezultātu.

Mainīgos vērtības, definīcijas un izmantojumu Mainīgo skatā var skatīt programmas Power Apps Studio izvēlnē Fails.

Kā redzams piemēros tālāk šajā tēmā, globālie mainīgie var saturēt dažāda veida informāciju, tostarp:

  • vienu vērtību
  • ierakstu
  • tabulu
  • objekta atsauci
  • jebkuru rezultātu no formulas

Globālais mainīgais saglabā savu vērtību, līdz tiek aizvērta programma. Pēc aizvēršanas globālā mainīgā vērtība tiks zaudēta un to ir jāizveido no jauna, kad programma tiek vēlreiz ielādēta.

Globālie mainīgie nevar izmantot tādu pašu nosaukumu, kāds ir esošai kolekcijai vai vadīklai. Tas var izmantot tādu pašu nosaukumu, kāds ir konteksta mainīgajam. Lai atšķirtu tos abus, izmantojiet norādīšanas operatoru.

Set nav atgrieztas vērtības, un to var izmantot tikai uzvedības formulā.

Sintakse

Set( VariableName, Value )

  • VariableName — Obligāti. Nosaukums globālajam mainīgajam, kas ir jāizveido vai jāatjaunina.
  • Value — Obligāti. Vērtība, kuru piešķir konteksta mainīgajam.

Piemēri

Formula Apraksts Rezultāts
Set( Counter, 1 ) Izveido vai modificē globālo mainīgo Skaitītājs, iestatot tā vērtību 1. Skaitītājam ir vērtība 1. Varat atsaukties uz šo mainīgo izmantojot nosaukumu Skaitītājs formulā jebkurā ekrānā.
Set( Counter, 2 ) Iestata globālā mainīgā Skaitītājs vērtību no iepriekšējā piemēra uz 2. Skaitītājam ir vērtība 2.
Set( Counter, Counter + 1 ) Palielina globālā mainīgā Skaitītājs vērtību no iepriekšējā piemēra uz 3. Skaitītājam ir vērtība 3.
Set( Vārds, "Lilija" ) Izveido vai modificē globālo mainīgo Nosaukums, iestatot tā vērtību Lilija. Nosaukumam ir vērtība Lilija.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) Izveido vai modificē globālo mainīgo Persona, iestatot tā vērtību uz ierakstu. Ierakstā ir divas kolonnas ar nosaukumu Vārds un Adrese. Kolonnas Vārds vērtība ir Milton, bet kolonnas Adrese vērtība ir 1 Main St. Personai ir ieraksta {Vārds: "Milton", Adrese: "1MainSt" }.

Atsaucieties uz šo ierakstu kā veselu ar nosaukumu Persona vai atsaucieties uz atsevišķu šī ieraksta kolonnu ar Person.Name vai Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Darbojas ar Patch funkciju, lai atjauninātu Personas globālo mainīgo, iestatot Adreses kolonnas vērtību uz 2 Main St. Personai tagad ir ieraksta { Vārds:"Milton", Adrese: "2 Main St }.