Fungsi set
Berlaku untuk:
Aplikasi kanvas Kartu Dataverse plug-in Power Platform kode rendah CLI
Menetapkan nilai variabel global.
Gambaran Umum
Gunakan fungsi Set untuk menetapkan nilai variabel global, yang sementara menyimpan bagian informasi, seperti berapa kali pengguna memilih tombol atau hasil dari operasi data.
Variabel global tersedia di seluruh aplikasi Anda di semua layar. Ini adalah jenis variabel yang paling sederhana dan memenuhi kebutuhan sebagian besar situasi. Juga ada variabel konteks yang disesuaikan untuk satu layar dan koleksi yang memungkinkan modifikasi tingkat baris ke tabel. Untuk informasi lebih lanjut pilihan lain tersebut, tinjau Memahami variabel.
Power Apps didasarkan pada rumus yang secara otomatis menghitung ulang saat pengguna berinteraksi dengan aplikasi. Setiap formula yang tergantung pada variabel akan secara otomatis diperbarui saat berubah. Namun, variabel tidak akan diperbarui secara otomatis jika nilai rumus yang digunakan dalam fungsi Set berubah. Ini memerlukan pembuat aplikasi untuk memperbarui variabel secara manual, yang dapat menjadi rentan terhadap kesalahan dan lebih sulit dipahami orang lain. Sebelum Anda menggunakan variabel, lihat Memahami variabel.
KETERANGAN
Variabel global secara implisit dibuat dengan menggunakan fungsi Set. Tidak ada pernyataan eksplisit yang diperlukan. Jika Anda menghapus semua fungsi Set untuk variabel global, variabel global akan berhenti tersedia. Untuk menghapus variabel yang mengatur nilainya ke hasil dari fungsi Blank.
Anda dapat melihat nilai variabel, definisi, dan penggunaan dengan tampilan Variabel di dalam menu File di Power Apps Studio.
Sebagai contoh nanti yang ditampilkan dalam topik, variabel global dapat memiliki beberapa jenis informasi, termasuk:
- satu nilai
- rekaman
- tabel
- referensi objek
- hasil apa pun dari rumus
Variabel global menyimpan nilainya hingga aplikasi ditutup. Setelah aplikasi ditutup, nilai variabel global akan hilang dan harus dibuat ulang saat aplikasi dimuat kembali.
Variabel global tidak dapat menggunakan nama yang sama sebagai kumpulan atau kontrol yang ada. Variabel global dapat menggunakan nama yang sama seperti variabel konteks. Untuk membedakan di antara keduanya, gunakan operator disambiguasi.
Set tidak memiliki nilai yang dihasilkan, dan Anda dapat menggunakannya hanya dalam rumus perilaku.
Sintaks
Set( VariableName, Value )
- VariableName - Wajib. Nama variabel global untuk membuat atau memperbarui.
- Value – Wajib. Nilai yang ditetapkan ke variabel konteks.
Contoh
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Set( Counter, 1 ) | Membuat atau memodifikasi Counter variabel global, mengatur nilainya ke 1. | Counter memiliki nilai 1. Anda dapat mereferensikan variabel tersebut menggunakan nama Counter dalam rumus pada layar apa pun. |
| Set( Counter, 2 ) | Menetapkan nilai variabel global Counter dari contoh sebelumnya ke 2. | Counter memiliki nilai 2. |
| Set( Counter, Counter + 1 ) | Meningkatkan nilai variabel global Counter dari contoh sebelumnya ke 3. | Counter memiliki nilai 3. |
| Set( Name, "Lily" ) | Membuat atau memodifikasi Name variabel global, mengatur nilainya ke Lily. | Name memiliki nilai Lily. |
| Set( Person, { Name: "Milton", Address: "1 Main St" } ) | Membuat atau memodifikasi Person variabel global, mengatur nilainya ke rekaman. Rekaman berisi dua kolom, bernama Nama dan Alamat. Nilai kolom Nama adalah Milton, dan nilai kolom Alamat adalah 1 Main St. | Person memiliki nilai rekaman { Name: "Milton", Address: "1 Main St" }. Rujuk rekaman ini secara keseluruhan dengan nama Persona, atau rujuk masing-masing kolom rekaman ini dengan Person.Name atau Person.Address. |
| Set( Person, Patch( Person, {Address: "2 Main St" } ) ) | Berfungsi dengan fungsi Patch untuk memperbarui variabel global Person dengan mengatur nilai kolom Alamat ke 2 Main St. | Person sekarang memiliki nilai rekaman { Name: "Milton", Address: "2 Main St" }. |