fungsi Set

Berlaku untuk: Aplikasi Kanvas Desktop mengalir fungsi Power Platform CLI Dataverse

Menetapkan nilai variabel global.

Gambaran Umum

Set Gunakan fungsi untuk mengatur nilai variabel global, yang untuk sementara menyimpan informasi, seperti berapa kali pengguna memilih tombol atau hasil 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 Set fungsi 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 dibuat secara implisit dengan menggunakan Set fungsi . Tidak ada pernyataan eksplisit yang diperlukan. Jika Anda menghapus semua Set fungsi untuk variabel global, variabel global tersebut akan berhenti ada. 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 pengembalian, dan Anda hanya dapat menggunakannya dalam rumus perilaku.

Sintaks

Set( VariableName, Value )

• VariableName - Wajib. Nama variabel global untuk membuat atau memperbarui.
• Nilai - Diperlukan. Nilai yang ditetapkan ke variabel konteks.

Contoh

Rumus	KETERANGAN	Hasil
Set(Penghitung, 1)	Membuat atau memodifikasi Counter variabel global, mengatur nilainya ke 1.	Penghitung memiliki nilai 1. Anda dapat mereferensikan variabel tersebut menggunakan nama Counter dalam rumus pada layar apa pun.
Set(Penghitung, 2)	Menetapkan nilai variabel global Counter dari contoh sebelumnya ke 2.	Penghitung memiliki nilai 2.
Set( Penghitung, Penghitung + 1 )	Meningkatkan nilai variabel global Counter dari contoh sebelumnya ke 3.	Penghitung memiliki nilai 3.
Set(Nama, "Lily" )	Membuat atau memodifikasi Name variabel global, mengatur nilainya ke Lily.	Nama memiliki nilai Lily.
Set( Orang, { Nama: "Milton", Alamat: "1 St Utama" } )	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.	Orang memiliki nilai catatan { Nama: "Milton", Alamat: "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( Orang, Patch( Orang, {Alamat: "2 St Utama" } ) )	Berfungsi dengan fungsi Patch untuk memperbarui variabel global Person dengan mengatur nilai kolom Alamat ke 2 Main St.	Orang sekarang memiliki nilai nama catatan { : "Milton", Alamat: "2 Main St" }.