Blank, Coalesce, IsBlank, dan IsEmpty fungsi

Fungsi	Terpakai kepada
Blank	Apl kanvas Copilot Studio Desktop mengalir lajur formula Dataverse Apl dipacu model Power Platform CLI Fungsi Dataverse
Coalesce IsEmpty	Apl kanvas Aliran Desktop Copilot Studio Apl dipacu model Power Platform CLI Fungsi Dataverse Halaman Kuasa
IsBlank	Apl kanvas Copilot Studio Desktop mengalir lajur formula Dataverse Apl dipacu model Power Platform CLI Fungsi Dataverse Halaman Kuasa

Menguji sama ada nilai kosong atau jadual mengandungi tiada rekod dan menyediakan kaedah untuk mencipta nilai kosong.

Ikhtisar

Blankialah ruang letak untuk "tiada nilai" atau "nilai tidak diketahui." Contohnya, sifat Selected kawalan kotak kombokosong jika pengguna belum membuat pilihan. Banyak sumber data boleh menyimpan dan mengembalikan nilai NOL yang diwakilkan dalam Power Apps sebagai kosong.

Sebarang sifat atau nilai yang dikira dalam Power Apps boleh menjadi kosong. Sebagai contoh, nilai Boolean biasanya mempunyai salah satu daripada dua nilai: benar atau palsu. Tetapi sebagai tambahan kepada kedua-duanya, ia juga boleh kosong menunjukkan bahawa negeri itu tidak dikenali. Ini adalah serupa dengan Microsoft Excel yang mana sel lembaran kerja bermula kosong tanpa kandungan tetapi boleh menyimpan nilai BENAR atau PALSU (antara lain). Pada bila-bila masa, kandungan sel boleh dikosongkan sekali lagi, mengembalikannya kepada keadaan kosong.

Rentetan kosong merujuk kepada rentetan yang tidak mengandungi aksara. Len function mengembalikan sifar untuk rentetan seperti itu dan ia boleh ditulis dalam formula sebagai dua tanda petik berganda dengan tiada apa-apa di antaranya "". Beberapa kawalan dan sumber data menggunakan rentetan kosong untuk menunjukkan syarat "tiada nilai". Untuk memudahkan penciptaan aplikasi, IsBlank fungsi dan Coalesce menguji kedua-dua nilai kosong atau rentetan kosong.

Dalam konteks IsEmpty fungsi, kosong adalah khusus untuk jadual yang tidak mengandungi rekod. Struktur jadual mungkin utuh, lengkap dengan lajur nama, tetapi tidak ada data dalam jadual. Jadual boleh dimulakan sebagai kosong, mengambil rekod dan tidak lagi kosong dan kemudian mengalih keluar rekod dan sekali lagi menjadi kosong.

Blank

Fungsi mengembalikan Blank nilai kosong . Gunakan ini untuk menyimpan nilai NOL dalam sumber data yang menyokong nilai ini, mengalih keluar sebarang nilai dengan berkesan dari medan.

IsBlank

Fungsi ini IsBlank menguji nilai kosong atau rentetan kosong. Ujian ini termasuk rentetan kosong untuk memudahkan penciptaan apl kerana sesetengah sumber data dan kawalan menggunakan rentetan kosong apabila tiada nilai hadir. Untuk menguji secara khusus untuk penggunaan if(Value = Blank(), ... nilai kosong dan bukannya IsBlank. Fungsi ini IsBlank menganggap jadual kosong sebagai tidak kosong, dan IsEmpty harus digunakan untuk menguji jadual.

Apabila mendayakan pengendalian ralat untuk apl sedia ada, pertimbangkan untuk menggantikan IsBlank dengan IsBlankOrError untuk mengekalkan tingkah laku apl sedia ada. Sebelum penambahan pengendalian ralat, nilai kosong digunakan untuk mewakili nilai nol daripada pangkalan data dan nilai ralat. Pengendalian ralat memisahkan kedua-dua tafsiran kosong ini, yang boleh mengubah tingkah laku apl sedia ada yang terus menggunakan IsBlank.

Nilai pulangan untuk IsBlank ialah boolean benar atau palsu.

Coalesce

Fungsi ini Coalesce menilai argumennya mengikut urutan dan mengembalikan nilai pertama yang tidak kosong atau rentetan kosong. Gunakan fungsi ini untuk menggantikan nilai kosong atau rentetan kosong dengan nilai yang berbeza tetapi meninggalkan bukan-kosong dan bukan rentetan kosong yang tidak berubah. Jika semua hujah adalah rentetan kosong atau kosong, maka fungsi mengembalikan kosong, menjadikan Coalesce cara yang baik untuk menukar rentetan kosong kepada nilai kosong .

Coalesce( value1, value2 ) adalah setara yang lebih ringkas dan If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) tidak memerlukan value1 dan value2 untuk dinilai dua kali. Fungsi Jika mengembalikan kosong jika tiada formula "lain" seperti yang berlaku di sini.

Semua hujah mestilah Coalesce daripada jenis yang sama; contohnya, anda tidak boleh mencampurkan nombor dengan rentetan teks. Nilai pulangan daripada Coalesce adalah daripada jenis biasa ini.

IsEmpty

Fungsi ini IsEmpty menguji sama ada jadual mengandungi sebarang rekod. Ia adalah sama dengan menggunakan fungsi CountRows dan menyemak untuk sifar. Anda boleh menyemak ralat sumber data dengan menggabungkan IsEmpty dengan fungsi Ralat .

Nilai pulangan untuk IsEmpty ialah Boolean benar atau palsu.

Sintaks

Blank()

Coalesce( Nilai1 [, Nilai2, ... ] )

• Nilai - Diperlukan. Nilai untuk menguji. Setiap nilai dinilai mengikut urutan sehingga nilai yang tidak kosong dan bukan rentetan kosong ditemui. Nilai selepas titik ini tidak dinilai.

IsBlank( Nilai )

• Nilai - Diperlukan. Nilai untuk ujian bagi nilai kosong atau rentetan kosong.

IsEmpty( Jadual )

• Jadual - Diperlukan. Jadual untuk menguji rekod.

Contoh

Blank

1. Cipta aplikasi dari awal dan tambahkan kawalan Butang.

2. Tetapan sifat OnSelect butang untuk formula ini:

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. Pratonton aplikasi anda, klik atau ketik butang yang anda tambahkan, dan kemudian tutup Pratonton.

4. Pada menu Fail, klik atau ketik Koleksi.

   Koleksi Bandar muncul, menunjukkan satu rekod dengan "Seattle" dan "Hujan":

   

5. Klik atau ketik anak panah belakang untuk kembali ke ruang kerja lalai.

6. Tambah kawalan Label dan tetapkannya sifat Teks untuk formula ini:

   IsBlank( First( Cities ).Weather )
   

   Label menunjukkan palsu kerana medan Cuaca mengandungi nilai ("Hujan").

7. Tambah butang kedua dan tetapkan sifat OnSelect untuk formula ini:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. Pratonton aplikasi anda, klik atau ketik butang yang anda tambahkan, dan kemudian tutup Pratonton.

   Medan Cuaca bagi rekod pertama dalam Bandar digantikan dengan kosong, mengalih keluar "Hujan" yang ada di sana sebelumnya.

   

   Label menunjukkan benar kerana medan Cuaca tidak lagi mengandungi nilai.

Coalesce

Formula	Penerangan	Hasil
Coalesce( Blank(), 1 )	Menguji nilai pulangan daripada Blank fungsi, yang sentiasa mengembalikan nilai kosong . Oleh sebab argumen pertama adalah kosong, penilaian diteruskan dengan argumen seterusnya sehingga nilai bukan-kosong dan bukan rentetan kosong.	1
Coalesce( "", "2" )	Menguji hujah pertama, yang merupakan rentetan kosong. Oleh sebab argumen pertama adalah rentetan kosong, penilaian diteruskan dengan argumen sehingga nilai bukan-kosong dan bukan rentetan kosong ditemui.	2
Coalesce( Blank( ), "", Blank(), "", "3", "4" )	Coalesce bermula pada permulaan senarai hujah dan menilai setiap hujah secara bergilir-gilir sehingga nilai tidak kosong dan rentetan tidak kosong ditemui. Dalam kes ini, empat argumen pertama semuanya mengembalikan kosong atau rentetan kosong, maka penilaian diteruskan ke argumen kelima. Argumen kelima adalah bukan-kosong dan bukan rentetan kosong, maka penilaian berhenti di sini. Nilai argumen kelima dikembalikan dan argumen keenam tidak dinilai.	3
Coalesce( "" )	Menguji hujah pertama, yang merupakan rentetan kosong. Oleh sebab argumen pertama adalah rentetan kosong dan tidak ada lagi argumen, fungsi itu kembali kosong.	Kosong

IsBlank

1. Cipta aplikasi dari awal, tambahkan kawalan input teks dan namakannya FirstName.

2. Tambah label, dan tetapkan sifat Teks ke formula ini:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Secara lalai, sifat Teks kawalan input teks ditetapkan ke "Input teks". Oleh sebab sifat mengandungi nilai, ia tidak kosong dan label tidak memaparkan sebarang mesej.

3. Alih keluarkan semua aksara dari kawalan input teks termasuk ruang.

   Oleh kerana sifat Text tidak lagi mengandungi sebarang aksara, ia adalah rentetan kosong dan IsBlank( FirstName.Text ) adalah benar. Mesej medan yang diperlukan dipaparkan.

Untuk maklumat tentang cara melaksanakan pengesahan dengan menggunakan alat lain, lihat fungsi Validate dan bekerja dengan sumber data.

Contoh lain:

Formula	Penerangan	Hasil
IsBlank( Blank() )	Menguji nilai pulangan daripada Blank fungsi, yang sentiasa mengembalikan nilai kosong .	Benar
IsBlank( "" )	Rentetan yang tidak mengandungi aksara.	Benar
IsBlank( "Helo" )	Rentetan yang mengandungi satu atau lebih aksara.	Palsu
IsBlank( Mana-manaKoleksi )	Oleh sebab koleksi wujud,ia tidak kosong walaupun tidak mengandungi rekod. Untuk menyemak koleksi kosong, gunakan IsEmpty sebaliknya.	Palsu
IsBlank( Pertengahan ( "Hello", 17, 2 ) )	Aksara permulaan untuk Mid berada di luar rentetan. Hasil adalah rentetan kosong.	Benar
IsBlank( Jika( palsu, palsu ) )	Fungsi If dengan tiada ElseResult. Oleh sebab syarat selalunya palsu, ini If sentiasa kembali kosong.	Benar

IsEmpty

1. Cipta aplikasi dari awal dan tambahkan kawalan Butang.

2. Tetapan sifat OnSelect butang untuk formula ini:

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 100} )

3. Pratonton aplikasi anda, klik atau ketik butang yang anda tambahkan, dan kemudian tutup Pratonton.

   Kolek yang dinamakan Ais Krim dicipta dan mengandungi data ini:

   

   Koleksi ini mempunyai dua rekod dan tidak kosong. IsEmpty( IceCream ) mengembalikan palsu, dan CountRows( IceCream ) mengembalikan 2.

4. Tambahkan butang kedua dan tetapkan sifat OnSelect untuk formula ini:

   Clear ( Ais Krim )

5. Pratonton aplikasi anda, klik atau ketik butang kedua dan kemudian tutup Pratonton.

   Koleksi kini kosong:

   

   Fungsi Clear mengalih keluar semua rekod dari koleksi, menghasilkan koleksi kosong. IsEmpty( IceCream ) mengembalikan benar, dan CountRows( IceCream ) mengembalikan 0.

Anda juga boleh menggunakan IsEmpty untuk menguji sama ada jadual terhitung kosong, seperti yang ditunjukkan oleh contoh ini:

Formula	Penerangan	Hasil
IsEmpty( [ 1, 2, 3 ] )	Jadual lajur tunggal mengandungi tiga rekod dan oleh itu, ia tidak kosong.	Palsu
IsEmpty( [ ] )	Jadual lajur tunggal tidak mengandungi rekod dan adalah kosong.	Benar
IsEmpty( Penapis ( [ 1, 2, 3 ], Nilai > 5 ) )	Jadual lajur tunggal tidak mengandungi nilai yang lebih besar daripada 5. Hasil dari penapis tidak mengandungi rekod dan kosong.	Benar