UpdateContext işlevi
Şunlar için geçerlidir:
Tuval uygulamaları
Geçerli ekranın bağlam değişkenlerini oluşturur veya güncelleştirir.
Genel bakış
Kullanıcının bir düğmeyi kaç kez seçtiği veya bir veri işleminin sonucu gibi bir bilgiyi geçici olarak saklayan bir bağlam değişkeni oluşturmak için UpdateContext işlevini kullanın.
Bağlam değişkenlerinin kapsamı bir ekranla sınırlıdır; başka bir deyişle, farklı bir ekranda bağlam değişkenine başvuran bir formül oluşturamazsınız. Başka bir programlama aracı kullandıysanız bağlam değişkenini yerel değişkene benzer olarak düşünebilirsiniz. Uygulamanız genelinde mevcut olan genel değişkenlerle çalışmak için Set işlevini kullanın.
Power Apps, kullanıcı bir uygulama ile etkileşim kurdukça otomatik olarak yeniden hesaplanan formülleri temel alır. Bu avantajı sunmayan bağlam değişkenleri uygulamanızın oluşturulmasını ve anlaşılmasını zorlaştırabilir. Bağlam değişkeni kullanmadan önce değişkenlerle çalışma bölümünü inceleyin.
Açıklama
Bağlam değişkeni oluşturmak veya güncelleştirmek için UpdateContext işlevine tek bir kayıt geçirin. Her bir kayıtta, değişkenin adını tanımlayan veya değişkenin adıyla eşleşen bir sütun adını ve bu değişkeni ayarlamak istediğiniz değeri belirtin.
- Önceden tanımladığınız bir değişkenin adını belirtirseniz UpdateContext, değişkenin değerini belirttiğiniz değer olarak ayarlar.
- Henüz mevcut olmayan bir değişkenin adını belirtirseniz UpdateContext, o adla bir değişken oluşturur ve bu değişkenin değerini belirttiğiniz değer olarak ayarlar.
- Önceden bir değişken tanımladıysanız ancak söz konusu UpdateContext formülünde bu değişkeni belirtmediyseniz değişkenin değeri aynı kalır.
Bağlam değişkenleri, UpdateContext veya Navigate işlevi kullanılarak örtük bir şekilde oluşturulur. Açık bildirim gerekmez. Bir bağlam değişkenine yönelik tüm UpdateContext ve Navigate başvurularını kaldırırsanız söz konusu bağlam değişkeni artık mevcut olmaz. Değişkeni silmek için değerini Blank işlevinin sonucu olarak ayarlayın.
Yazma ortamında Dosya menüsünün altındaki Değişkenler görünümü sayesinde değişkenlerinizin değerlerini, tanımlarını ve kullanımlarını görebilirsiniz.
Değişkenin sütun adını kullanarak bir formülde bağlam değişkenine başvurursunuz. Örneğin, UpdateContext( { ShowLogo: doğru } )ShowLogo adlı bir bağlam değişkeni oluşturur ve bu bağlam değişkeninin değerini doğru olarak ayarlar. Bir formülde ShowLogo adını kullanarak bu bağlam değişkeninin değerini kullanabilirsiniz. Bir image denetiminin Visible özelliği için formül olarak ShowLogo yazabilir ve bağlam değişkeni değerinin doğru mu yoksa yanlış mı olduğuna bağlı olarak bu denetimi gösterebilir veya gizleyebilirsiniz.
Bu konunun ilerleyen bölümlerinde verilen örneklerde gösterildiği gibi bağlam değişkenleri, aşağıdakiler dahil olmak üzere çok çeşitli bilgiler içerebilir:
- tek bir değer
- bir kayıt
- bir tablo
- bir nesne başvurusu
- bir formülün herhangi bir sonucu
Bağlam değişkeni, uygulama kapatılana kadar değerini korur. Belirli bir ekranda bağlam değişkeni tanımlar ve değerini ayarlarsanız kullanıcı farklı bir ekrana geçse bile bu bilgiler değişmeden kalır. Uygulama kapatıldıktan sonra bağlam değişkeninin değeri kaybolur ve uygulama tekrar yüklendiğinde değerin yeniden oluşturulması gerekir.
Tüm bağlam değişkenlerinin kapsamı bir ekranla sınırlıdır. Bir ekranda bağlam değişkeni tanımlamak ve başka bir ekrandan bu değişkeni değiştirmek istiyorsanız Navigate işlevini temel alan bir formül oluşturmanız gerekir. Alternatif olarak, bir genel değişken kullanın.
UpdateContext hiçbir değer döndürmez ve bu işlevi yalnızca bir davranış formülünde kullanabilirsiniz.
Sözdizimi
UpdateContext( UpdateRecord )
- UpdateRecord: Gerekli. En az bir sütun adı ve söz konusu sütun için bir değer içeren kayıt. Belirttiğiniz her bir sütun ve değer için bir bağlam değişkeni oluşturulur veya güncelleştirilir.
UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )
- ContextVariable1 - Gerekli. Oluşturulacak veya güncelleştirilecek bir bağlam değişkeninin adı.
- Value1 - Gerekli. Bağlam değişkenine atanacak değer.
- ContextVariable2: Value2, ... - İsteğe bağlı. Oluşturulacak veya güncelleştirilecek ek bağlam değişkenleri ve bunların değerleri.
Örnekler
| Formül | Açıklama | Sonuç |
|---|---|---|
| UpdateContext( { Counter: 1 } ) | Sayaç bağlam değişkenini oluşturur veya değiştirir ve değerini 1 olarak ayarlar. | Sayaç, 1 değerine sahiptir. Bir formülde Sayaç adını kullanarak bu değişkene başvurabilirsiniz. |
| UpdateContext( { Counter: 2 } ) | Bir önceki örnekte yer alan Sayaç bağlam değişkeninin değerini 2 olarak ayarlar. | Sayaç, 2 değerine sahiptir. |
| UpdateContext( { Name: "Lily", Score: 10 } ) | Ad ve Puan bağlam değişkenlerini oluşturur veya değiştirir ve değerlerini sırasıyla Lily ve 10 olarak ayarlar. | Ad, Lily değerine ve Puan, 10 değerine sahiptir. |
| UpdateContext( { Person: { Name: "Milton", Address: "1 Main St" } } ) | Kişi bağlam değişkenini oluşturur veya değiştirir ve değerini bir kayıt olarak ayarlar. Bu kayıt Ad ve Adres adlı iki sütuna sahiptir. Ad sütununun değeri Milton ve Adres sütununun değeri 1 Main St olarak belirlenmiştir. | Kişi kaydın değerine sahiptir { Name: "Milton", Address: "1 Main St" } }. Kişi adını kullanarak bu kaydın tamamına başvurabileceğiniz gibi Kişi.Ad veya Kişi.Adres ile bu kayıttaki sütunların birine başvurabilirsiniz. |
| UpdateContext( { Person: Patch( Person, {Address: "2 Main St" } ) } ) | Patch işleviyle birlikte çalışarak Kişi bağlam değişkeninin Adres sütununu 2 Main St olarak ayarlar. | Kişi artık kaydın değerine sahiptir { Name: "Milton", Address: "2 Main St" } }. |
Adım adım örnek 1
Varsayılan ekranı Kaynak olarak adlandırın ve başka bir ekran ekleyip Hedef olarak adlandırın.
Kaynak ekranına iki düğme ekleyin ve bunların Text özelliklerini, biri İngilizce ve diğeri İspanyolca olacak şekilde ayarlayın.
İngilizce düğmesinin OnSelect özelliğini şu ifade olarak ayarlayın:
Navigate(Target, ScreenTransition.Fade, {Language:"English"})İspanyolca düğmesinin OnSelect özelliğini şu ifade olarak ayarlayın:
Navigate(Target, ScreenTransition.Fade, {Language:"Spanish"})Hedef ekranına bir etiket ekleyin ve Text özelliğini şu ifade olarak ayarlayın:
If(Dil="İngilizce", "Hello!", "Hola!")Hedef ekranında, Ekle sekmesinde Şekiller seçeneğini belirleyin ve ardından Geri okunu seçin.
Geri okunun OnSelect özelliğini şu formül olarak ayarlayın:
Navigate(Kaynak, ScreenTransition.Fade)Kaynak ekranında F5 tuşuna basın ve ardından iki dilden birine ilişkin düğmeyi seçin.
Hedef ekranındaki etiket, seçtiğiniz düğmeye karşılık gelen dilde görüntülenir.
Kaynak ekranına geri dönmek için Geri okunu ve ardından diğer dile ilişkin düğmeyi seçin.
Hedef ekranındaki etiket, seçtiğiniz düğmeye karşılık gelen dilde görüntülenir.
Varsayılan çalışma alanına dönmek için Esc tuşuna basın.
Adım adım örnek 2
- Bu formülü kullanmak istediğiniz tuval uygulamasını açın.
- Komut çubuğundan Yeni ekran seçeneğini belirleyerek yeni bir boş ekran ekleyin.
- Bir düğme ekleyin ve düğmenin OnSelect özelliğini şu formül olarak ayarlayın:
UpdateContext( { Name: "Lily", Score: 10 } )