Blank, , CoalesceIsBlank, și IsEmpty funcții

Funcţii	Se aplică la
Blank	Aplicațiile Pânză Copilot Studio Desktop fluxurilor de dateVerse coloanele de formule bazate pe modele de aplicații Power Platform CLI Dataverse
Coalesce IsEmpty	Aplicații pânză Copilot Studio Desktop fluxuri model aplicații bazate pe modele Power Platform ClI Dataverse funcții Power Pages
IsBlank	Aplicațiile Pânză Copilot Studio Desktop fluxurilor de dateVerse coloane de formule Model aplicații bazate pe platforma Power Platform CLI Dataverse funcții Power Pages

Testează dacă o valoare este necompletată sau dacă un tabel nu conține înregistrări și oferă o modalitate de a crea valori necompletate.

Prezentare generală

Blankeste un substituent pentru "nicio valoare" sau "valoare necunoscută". De exemplu, proprietatea Selected a controlului casetă combo este necompletată dacă utilizatorul nu a efectuat o selecție. Multe surse de date pot stoca și returna valorile NULL, care sunt reprezentate în Power Apps ca necompletat.

Orice proprietate sau valoare calculată în Power Apps poate fi necompletată. De exemplu, o valoare booleană are în mod normal una dintre aceste două valori: true sau false. Dar, în plus față de aceste două, poate fi, de asemenea, necompletată , care indică faptul că starea nu este cunoscută. Acest lucru este similar cu Microsoft Excel, unde o celulă a foii de lucru începe ca fiind necompletată fără conținut, dar poate păstra valorile TRUE sau FALSE (printre altele). În orice moment, conținutul celulei poate fi din nou șters, returnându-l la starea gol.

Șirul gol se referă la un șir care nu conține caractere. Funcția Len returnează zero pentru un astfel de șir și poate fi scris într-o formulă ca două ghilimele duble, fără nimic între "" . Unele controale și surse de date utilizează un șir gol pentru a indica o condiție "fără valoare". Pentru a simplifica crearea aplicațiilor, funcțiile și Coalesce testați IsBlank atât valorile necompletate, cât șirurile goale.

În contextul funcției IsEmpty , golul este specific tabelelor care nu conțin înregistrări. Structura tabelului poate fi intactă, completă cu coloană nume, dar nu există date în tabel. Un tabel poate începe la fel de gol, să preia înregistrările și să nu mai fie gol, iar apoi înregistrările să fie eliminate și să fie din nou goale.

Blank

Funcția Blank returnează o valoare necompletată . Folosiți aceasta pentru a stoca o valoare NULL într-o sursă de date care acceptă aceste valori, eliminând efectiv orice valoare din câmp.

IsBlank

Funcția IsBlank testează o valoare necompletată sau un șir gol. Testul include șiruri goale pentru a facilita crearea aplicațiilor, deoarece unele surse de date și controale utilizează un șir gol atunci când nu există nicio valoare prezentă. Pentru a testa în mod specific pentru utilizarea unei valori if(Value = Blank(), ...necompletate în loc de IsBlank. Funcția IsBlank consideră tabele goale ca necompletate și IsEmpty ar trebui utilizate pentru a testa un tabel.

Atunci când activați gestionarea erorilor pentru aplicațiile existente, luați în considerare înlocuirea IsBlank cu IsBlankOrError pentru a păstra comportamentul de aplicație existent. Înainte de adăugarea gestionării erorilor, o valoare necompletată a fost utilizată pentru a reprezenta atât valori nule din baze de date, cât și valori de eroare. Gestionarea erorilor separă aceste două interpretări ale spațiilor necompletate, care ar putea modifica comportamentul aplicațiilor existente care continuă să utilizeze IsBlank.

Valoarea returnată pentru IsBlank este o valoare booleană adevărată sau falsă.

Coalesce

Funcția Coalesce evaluează argumentele sale în ordine și returnează prima valoare care nu este necompletată sau un șir gol. Utilizați această funcție pentru a înlocui o valoare necompletată sau un șir gol cu o valoare diferită, dar lăsați neschimbate valorile care nu sunt necompletate și ale șirurilor care nu sunt goale. Dacă toate argumentele sunt șiruri necompletate sau goale, funcția returnează necompletat, făcând Coalesce o modalitate bună de a efectua conversia șirurilor goale la valori necompletate .

Coalesce( value1, value2 ) este echivalentul mai concis al If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) și nu necesită valoare1 și valoare2 pentru fi evaluat de două ori. Funcția If returnează necompletată dacă nu există nicio formulă "else" așa cum este cazul aici.

Toate argumentele trebuie să Coalesce fie de același tip; de exemplu, nu puteți amesteca numere cu șiruri text. Valoarea returnată de la Coalesce este de acest tip comun.

IsEmpty

Funcția IsEmpty testează dacă un tabel conține înregistrări. Este echivalent cu utilizarea funcției CountRows și cu verificarea pentru un zero. Puteți căuta erorile sursei de date combinând IsEmpty funcția Erori .

Valoarea returnată pentru IsEmpty este o valoare booleană adevărată sau falsă.

Sintaxă

Blank()

Coalesce( Valoare1 [, Valoare2, ... ] )

• Valori – Obligatoriu. Valori de testat. Fiecare valoare este evaluată în ordine până când se găsește o valoare care nu este necompletată și nu un șir gol. Valorile după acest punct nu sunt evaluate.

IsBlank( Valoare )

• Valoare – Obligatoriu. Valoarea de testat pentru o valoare necompletată sau un șir gol.

IsEmpty( Tabel )

• Tabel - Obligatoriu. Tabel pentru testarea înregistrărilor.

Exemple

Blank

1. Creați o aplicație de la zero și adăugați un control Buton.

2. Setați proprietatea OnSelect a butonului la această formulă:

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

3. Previzualizați aplicația, faceți clic sau atingeți butonul adăugat, apoi închideți Previzualizare.

4. În meniul Fișier, faceți clic pe Colecții sau atingeți.

   Apare colecția Orașe, arătând o înregistrare cu "Seattle" și "Ploios":

   

5. Faceți clic sau atingeți săgeata înapoi pentru a reveni la spațiul de lucru implicit.

6. Adăugați un control Label și setați proprietatea Text la această formulă:

   IsBlank( First( Cities ).Weather )
   

   Eticheta arată false deoarece câmpul Vreme conține o valoare ("Ploaie").

7. Adăugați un al doilea buton, apoi setați proprietatea OnSelect la această formulă:

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

8. Previzualizați aplicația, faceți clic sau atingeți butonul adăugat, apoi închideți Previzualizare.

   Câmpul Vreme al primei înregistrări din Orașe se înlocuiește cu necompletat, eliminând "Ploaie" care era acolo anterior.

   

   Eticheta arată true deoarece câmpul Vreme nu mai conține o valoare.

Coalesce

Formulă	Descriere	Rezultat
Coalesce( ( Blank), 1 )	Testează valoarea returnată din Blank funcție, care returnează întotdeauna o valoare necompletată . Pentru că primul argument este necompletat, evaluarea continuă cu următorul argument până la o valoare non-necompletat, iar șirul care nu este gol este găsit.	1
Coalesce( "", "2" )	Testează primul argument, care este un șir gol. Pentru că primul argument este un șir gol, evaluarea continuă cu următorul argument până la o valoare non-necompletat, iar șirul care nu este gol este găsit.	2
Coalesce( ( Blank), "", Blank(), "", "3", "4" )	Coalesce începe de la începutul listei de argumente și evaluează la rândul său fiecare argument până când se găsește o valoare necompletată și un șir necompletat. În acest caz, primele patru argumente returnează toate necompletat sau un șir gol, deci evaluarea continuă până la al cincilea argument. Al cincilea argument este non-necompletat, iar șirul nu este gol, deci evaluarea se oprește aici. Valoarea celui de-al cincilea argument este returnată și al șaselea argument nu este evaluat.	3
Coalesce( "" )	Testează primul argument, care este un șir gol. Deoarece primul argument este un șir gol și nu mai există argumente, funcția returnează necompletat.	necompletat

IsBlank

1. Creați o aplicație de la zero, adăugați un control de intrare text și denumiți-l Prenume.

2. Adăugați o etichetă și setați proprietatea Text conform acestei formule:

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

   În mod implicit, proprietatea Text a unui control de intrare text este setată la "Intrare text". Deoarece proprietatea conține o valoare, nu este necompletată, iar eticheta nu afișează niciun mesaj.

3. Eliminați toate caracterele din controlul de introducere a textului, inclusiv orice spații.

   Deoarece proprietatea Text nu mai conține caractere, este un șir gol și IsBlank( Prenume.Text ) este adevărat. Se afișează mesajul câmpului obligatoriu.

Pentru informații despre cum să efectuați validarea folosind alte instrumente, consultați funcția Validate și lucrul cu surse de date.

Alte exemple:

Formulă	Descriere	Rezultat
IsBlank( ( Blank) )	Testează valoarea returnată din Blank funcție, care returnează întotdeauna o valoare necompletată .	adevărat
IsBlank( "" )	Un șir care nu conține caractere.	adevărat
IsBlank( "Salut" )	Un șir care nu conține unu sau mai multe caractere.	fals
IsBlank( AnyCollection )	Întrucât collection există, nu este necompletat, chiar dacă nu conține înregistrări. Pentru a căuta o colecție goală, utilizați IsEmpty în schimb.	fals
IsBlank( Mid( "Hello", 17, 2 )	Personajul de pornire pentru Mid este dincolo de capătul șirului. Rezultatul este un și gol.	adevărat
IsBlank( If( fals, fals ) )	O funcție If cu ElseResult. Pentru că starea este întotdeauna false, acest If returnează întotdeauna necompletat.	adevărat

IsEmpty

1. Creați o aplicație de la zero și adăugați un control Buton.

2. Setați proprietatea OnSelect a butonului la această formulă:

   Collect( IceCream, {Aroma: "Capsuni", Cantitate: 300}, {Aroma: "ciocolata", Cantitate: 100} )

3. Previzualizați aplicația, faceți clic sau atingeți butonul adăugat, apoi închideți Previzualizare.

   O colecție numită Inghetata este creată și conține aceste date:

   

   Această colecție are două înregistrări și nu este goală. IsEmpty( IceCream ) returnează fals și CountRows( IceCream ) returnează 2.

4. Adăugați un al doilea buton, apoi setați proprietatea OnSelect la această formulă:

   Șterge (înghețată)

5. Previzualizați aplicația, faceți clic sau atingeți al doilea buton, apoi închideți Previzualizare.

   Colecția este acum goală:

   

   Funcția Clear elimină toate înregistrările dintr-o colecție, rezultând o colecție goală. IsEmpty( IceCream ) returnează adevărat și CountRows( IceCream ) returnează 0.

De asemenea, puteți utiliza IsEmpty pentru a testa dacă un tabel calculat este gol, așa cum arată aceste exemple:

Formulă	Descriere	Rezultat
IsEmpty( [ 1, 2, 3 ] )	Tabelul cu o singură coloană conține trei înregistrări și, prin urmare, nu este gol.	fals
IsEmpty( [ ] )	Tabelul cu o singură coloană nu conține înregistrări și este gol.	adevărat
IsEmpty( Filter( [ 1, 2, 3 ], Valoare > 5 )	Tabelul cu o singură coloană nu conține valori mai mari de 5. Rezultatul filtrului nu conține înregistrări și este gol.	adevărat