Funktsioon UpdateContext

  • Artikkel

Kehtib: Lõuendirakendused

Loob või värskendab praeguse ekraani konteksti muutujaid.

Ülevaade

Kasutage funktsiooni UpdateContext konteksti muutuja loomiseks, mis sisaldab ajutiselt teatud teavet, näiteks seda, mitu korda on kasutaja valinud nupu või andmete kasutamise tulemuse.

Konteksti muutujad on kuvatud ekraanile, mis tähendab, et te ei saa luua valemit, mis viitab mõnel teisel ekraanil olevale konteksti muutujale. Kui olete kasutanud mõnda muud programmeerimistööriista, võite arvata, et konteksti muutuja on sarnane kohaliku muutujaga. Kasutage funktsiooni Set, et töötada globaalsete muutujatega, mis on saadaval terves rakenduses.

Power Apps põhineb valemitel, mis arvutatakse automaatselt, kui kasutaja suhtleb rakendusega. Konteksti muutujad ei paku seda eelist ning võivad muuta rakenduse loomise ja mõistmise keerulisemaks. Enne konteksti muutuja kasutamist vaadake läbi teema Muutujatega töötamine.

Kirjeldus

Konteksti muutuja loomiseks või värskendamiseks andke üks kirje funktsioonile UpdateContext. Määrake igas kirjes veeru nimi, mis määratleb muutuja nime või vastab sellele, ja väärtus, millele soovite selle muutuja määrata.

  • Kui määrate varem määratletud muutuja nime, määrab funktsioon UpdateContext muutuja väärtuse teie määratud väärtusele.
  • Kui määrate sellise muutuja nime, mida pole veel olemas, loob funktsioon UpdateContext muutuja selle nimega ja seab muutuja väärtuse teie määratud väärtusele.
  • Kui olete varem määratlenud muutuja, kuid ei määra seda selles konkreetses valemis UpdateContext, jääb selle väärtus samaks.

Konteksti muutujad luuakse kaudselt funktsiooniga UpdateContext või Navigate. Selgesõnalist deklaratsiooni ei nõuta. Kui eemaldate kõik funktsioonide UpdateContext ja Navigate viited konteksti muutujale, siis selle konteksti muutuja lakkab olemast. Muutuja tühjendamiseks määrake selle väärtuseks funktsiooni Blank tulemus.

Saate vaadata oma muutujate väärtusi, määratlusi ja kasutusviise koostava keskkonna menüü Fail jaotises vaatega Muutujad.

Viide valemis konteksti muutujale, kasutades muutuja veeru nime. Näiteks loob UpdateContext( { ShowLogo: true } ) konteksti muutuja nimega ShowLogo ja määrab selle väärtuseks true. Seejärel saate selle muutuja väärtust kasutada, kasutades valemis nime ShowLogo. Saate kirjutada nime ShowLogo kui valemi pildi juhtelemendi atribuudi Visible jaoks ning kuvada või peita juhtelemendi vastavalt sellele, kas konteksti muutuja väärtus on true või false.

Selles teemas leiduvate näidetena võivad konteksti muutujad sisaldada mitut tüüpi teavet, sh järgmisi.

  • Üks väärtus
  • Kirje
  • Tabel
  • Objekti viide
  • Valemi tulemid

Konteksti muutuja mahutab selle väärtuse kuni rakendus suletakse. Kui määratlete konteksti muutuja ja määrate selle väärtuse kindlal ekraanil, jääb see teave puutumatuks isegi juhul, kui kasutaja aktiveerib mõne muu ekraani. Pärast rakenduse sulgemist läheb konteksti muutuja väärtus kaotsi ja see tuleb uuesti luua, kui rakendus uuesti laaditakse.

Iga konteksti muutuja laiendatakse ekraanile. Kui soovite määratleda konteksti muutuja ühel ekraanil ja muuta seda muutujat mõnel muul ekraanil, peate looma valemi, mis põhineb funktsiooni Navigate. Või kasutage globaalset muutujat.

UpdateContext ei tagastata väärtust ja seda saab kasutada ainult käitumise valemis.

Süntaks

UpdateContext( UpdateRecord )

  • UpdateRecord – Nõutav. Kirje, mis sisaldab vähemalt ühe veeru nime ja selle veeru väärtust. Iga teie määratud veeru ja väärtuse jaoks luuakse või värskendatakse konteksti muutuja.

UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )

  • ContextVariable1 - Nõutav. Konteksti muutuja nimi, mida soovite luua või värskendada.
  • Value1 - Nõutav. Väärtus, mis määratakse konteksti muutujale.
  • ContextVariable2: Value2, ... - Valikuline. Täiendavad konteksti muutujad, mida luua või värskendada, ja nende väärtused.

Näited

Valem Kirjeldus Tulem
UpdateContext( { Loendaja: 1 } ) Loob või muudab konteksti muutujat Counter, määrates selle väärtuseks 1. Loenduril on väärtus 1. Saate viidata muutujale, kasutades valemis nime Counter.
UpdateContext( { Loendaja: 2 } ) Määrab konteksti muutuja Counter väärtuse eelmisest näitest väärtusele 2. Loenduril on väärtus 2.
UpdateContext( { Nimi: „Lily”, skoor: 10 } ) Loob või muudab konteksti muutujad Name ja Score, määrates nende väärtusteks vastavalt Lily ja 10. Nime väärtus on Lily ja Skoori väärtus on 10.
UpdateContext( { Isik: { Nimi: „Milton”, Aadress: „1 peatänav” } } ) Loob või muudab konteksti muutujat Person, määrates selle väärtuseks kirje. Kirje sisaldab kahte veergu, mille nimeks on Name ja Address. Veeru Name väärtus on Milton ja veeru Address väärtus on 1 Main St. Isiku väärtus on kirje { Nimi: „Milton”, Aadress: „1 peatänav” } }.

Viidake kirjele tervikuna nimega Person või viidake selle kirje individuaalsele veerule kui Person.Name või Person.Address.
UpdateContext( { Isik: Paigaldus( Isik, {Aadress: „2 peatänav” } ) } ) Töötab funktsiooniga Patch, et värskendada konteksti muutujat Person, seades veeru Address väärtuseks 2 Main St. Isiku väärtuse kirje on nüüd { Nimi: „Milton”, Aadress: „2 peatänav” } }.

Üksikasjalik näidis 1

  1. Nimetage vaikimisi ekraani väärtuseks Source, lisage teine ekraan ja nimetage see kui Target.

  2. Lisage ekraanil Source kaks nuppu ja määrake nende atribuudid Text, nii et üks on English ja teine Spanish.

  3. Määrake atribuut OnSelect nupul English järgmisele avaldisele.
    Navigeeri(Sihtmärk, ScreenTransition.Fade, {Keel:„Inglise”})

  4. Määrake atribuut OnSelect nupul Spanish järgmisele avaldisele.
    Navigeeri(Sihtmärk, ScreenTransition.Fade, {Keel:„Hispaania”})

  5. Lisage ekraanil Target silt ja määrake selle atribuut Text järgmisele avaldisele.
    If(Language="English", "Hello!", "Hola!")

  6. Valige ekraanil Target vahekaardil Insert suvand Shapes ja seejärel klõpsake tagasinoolt.

  7. Määrake tagasinoole atribuut OnSelect järgmisele valemile.
    Navigate(Source, ScreenTransition.Fade)

  8. Vajutage ekraanil Source nuppu F5 ja seejärel valige soovitud keelele vastav nupp.

    Ekraanil Target kuvatakse silt keeles, mis vastab valitud nupule.

  9. Valige tagasinool, et naasta ekraanile Source ja seejärel valige teise keele nupp.

    Ekraanil Target kuvatakse silt keeles, mis vastab valitud nupule.

  10. Vajutage vaike-tööruumi naasmiseks paoklahvi (ESC).

Üksikasjalik näidis 2

  1. Avage lõuendirakendus kus te soovite seda valemit kasutada.
  2. Uue tühja ekraani lisamiseks valige menüüribalt uus ekraan.
  3. Lisage nupp ja määrake selle atribuudi OnSelect väärtus järgmisele valemile:
    UpdateContext( { Nimi: „Lily”, skoor: 10 } )