Bagikan melalui

Atur fungsi

  • Artikel

Berlaku untuk: Aplikasi kanvas Kartu Dataverse plug-in Power Platform low-code 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 pengembalian, dan Anda hanya dapat menggunakannya dalam rumus perilaku.

Sintaks

Set(Nama Variabel,Nilai )

  • 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 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. 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, Tambalan(Orang,Alamat {: "2 Main St" } ) 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" }.