Set işlevi

Geçerli olduğu durumlar: Tuval uygulamaları Kartlarıaz Dataverse kodlu eklentiler Power Platform CLI

Genel bir değişkenin değerini ayarlar.

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 genel değişkenin değerini belirlemek için Set işlevini kullanabilirsiniz.

Genel değişkenler uygulamanızın tüm ekranlarında kullanılabilir. Bunlar en basit türdeki değişkenlerdir ve birçok durumda ihtiyacı karşılar. Bunlara ek olarak tek bir ekranda kullanılan bağlam değişkenleri ve tablolarda satır düzeyinde değişiklik yapılmasını sağlayan koleksiyonlar mevcuttur. Diğer seçenekler hakkında daha fazla bilgi için Değişkenleri anlama bölümünü inceleyin.

Power Apps, kullanıcı bir uygulama ile etkileşim kurdukça otomatik olarak yeniden hesaplanan formülleri temel alır. Bir değişkene dayanan tüm formüller, değiştiğinde otomatik olarak güncelleştirilir. Ancak Set işlevinde kullanılan formülün değeri değişirse değişken otomatik olarak güncelleştirilmez. Bu, hataya açık ve başkaları tarafından anlaşılması daha zor olabilecek değişkeni el ile güncelleştirme işlemi için uygulama oluşturucusunu gerektirir. Değişken kullanmadan önce Değişkenleri anlama bölümünü inceleyin.

Açıklama

Genel değişkenler Set işlevi aracılığıyla örtük olarak oluşturulur. Açık bildirim gerekmez. Bir genel değişkene ait olan tüm Set işlevlerini kaldırırsanız genel değişken de ortadan kalkacaktır. Değişkeni silmek için değerini Blank işlevinin sonucu olarak ayarlayın.

Power Apps Studio'da 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.

Bu konunun ilerleyen bölümlerinde verilen örneklerde gösterildiği gibi genel değişkenler 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

Genel değişken uygulama kapatılana kadar değerini korur. Uygulama kapatıldıktan sonra genel değişkenin değeri kaybolur ve uygulama tekrar yüklendiğinde değerin yeniden oluşturulması gerekir.

Genel değişkenler mevcut bir koleksiyon veya denetimle aynı adı kullanamaz. Bağlam değişkeniyle aynı adı kullanabilir. İkisi arasındaki belirsizliği ortadan kaldırmak için kesinleştirme işlecini kullanın.

Set'in dönüş değeri yoktur ve bunu yalnızca bir davranış formülü içinde kullanabilirsiniz.

Sözdizimi

Set( DeğişkenAdı,Değer )

• VariableName - Gerekli. Oluşturulacak veya güncelleştirilecek genel değişkenin adı.
• Değer - Gerekli. Bağlam değişkenine atanacak değer.

Örnekler

Formül	Açıklama	Sonuç
Set( Sayaç, 1 )	Sayaç genel değişkenini oluşturur veya değiştirir ve değerini 1 yapar.	Sayaç 1 değerinesahiptir. Herhangi bir ekrandaki formülde Sayaç adını kullanarak bu değişkene başvurabilirsiniz.
Set( Sayaç, 2 )	Bir önceki örnekte yer alan Sayaç genel değişkeninin değerini 2 yapar.	Sayaç 2 değerinesahiptir.
Set( Sayaç, Sayaç + 1 )	Bir önceki örnekte yer alan Sayaç genel değişkeninin değerini artırarak 3 yapar.	Sayaç 3 değerinesahiptir.
Set( İsim, "Lily" )	Ad genel değişkenini oluşturur veya değiştirir ve değerini Lily yapar.	İsim Lily değerinesahiptir.
Set( Kişi, { İsim: "Milton", Adres: "1 Main St" } )	Kişi genel 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 kayıt { değerine sahiptir Ad: "Milton", Adres: "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.
Set( Kişi, Yama ( Kişi, { Adres: "2 Ana Cadde" } ) )	Patch işleviyle birlikte çalışarak Kişi genel değişkeninin Adres sütununu 2 Main St şeklinde güncelleştirir.	Kişi artık kayıt { değerine sahiptir Ad: "Milton", Adres: "2 Main St" }.