Blank, Coalesce, IsBlanki funcions IsEmpty

Funcions	S'aplica a
Blank	Aplicacions de llenç Copilot Studio Fluxos d'escriptori Columnes de fórmules del Dataverse Aplicacions basades en models CLI del Power Platform Funcions del Dataverse
Coalesce IsEmpty	Aplicacions de llenç Copilot Studio Fluxos d'escriptori Aplicacions basades en models CLI del Power Platform Funcions del Dataverse Power Pages
IsBlank	Aplicacions de llenç Copilot Studio Fluxos d'escriptori Columnes de fórmules del Dataverse Aplicacions basades en models CLI del Power Platform Funcions del Dataverse Power Pages

Prova si un valor és en blanc o si una taula no conté registres i proporciona una manera de crear valors en blanc.

Informació general

Blankés un marcador de posició per a "sense valor" o "valor desconegut". Per exemple, la propietat Selected d'un control de quadre combinat està en blanc si l'usuari no ha fet cap selecció. Moltes fonts de dades poden emmagatzemar i retornar valors NULL, que es representen al Power Apps en blanc.

Qualsevol propietat o valor calculat del Power Apps pot ser en blanc. Per exemple, un valor booleà normalment té un dels dos valors: true o false. Però a més d'aquests dos, també pot estar en blanc indicant que l'estat no es coneix. Això és similar al Microsoft Excel, en què una cel·la de full de càlcul comença en blanc i sense contingut, però pot tenir els valors TRUE o FALSE (entre d'altres). Es pot esborrar el contingut de la cel·la en qualsevol moment i tornar-la a un estat en blanc.

La cadena buida es refereix a una cadena que no conté caràcters. La funció Len torna zero per a aquesta cadena i es pot escriure en fórmules com a dues cometes dobles sense res al mig "". Alguns controls i fonts de dades utilitzen una cadena buida per indicar que es tracta d'una condició "no valor". Per simplificar la creació d'aplicacions, les IsBlank funcions i Coalesce proven tant els valors en blanc com les cadenes buides.

En el context de la IsEmpty funció, empty és específic de les taules que no contenen registres. L'estructura de la taula pot estar intacta, completa amb noms de columna, però sense dades a la taula. Una taula pot començar com a buida, prendre registres i deixar d'estar-ho. Després, se'n poden suprimir els registres i tornar a estar buida.

Blank

La Blank funció retorna un valor en blanc . Utilitzeu-la per emmagatzemar un valor NULL en una font de dades que admeti aquests valors, la qual cosa suprimeix eficaçment qualsevol valor del camp.

IsBlank

La IsBlank funció prova un valor en blanc o una cadena buida. La prova inclou cadenes buides per facilitar la creació d'aplicacions, ja que algunes fonts de dades i controls utilitzen una cadena buida quan no hi ha cap valor present. Per provar específicament un valor en blanc , utilitzeu if(Value = Blank(), ... en lloc de IsBlank. La IsBlank funció considera que les taules buides no estan en blanc i IsEmpty s'ha d'utilitzar per provar una taula.

Quan habiliteu la gestió d'errors per a les aplicacions existents, considereu la possibilitat de substituir-la IsBlank per IsBlankOrError per conservar el comportament de l'aplicació existent. Abans d'afegir la gestió d'errors, s'utilitzava un valor en blanc per representar valors nuls de bases de dades i valors d'error. La gestió d'errors separa aquestes dues interpretacions de blanc, cosa que podria canviar el comportament de les aplicacions existents que continuen utilitzant IsBlankel .

El valor de retorn per IsBlank és un booleà true o false.

Coalesce

La Coalesce funció avalua els seus arguments en ordre i retorna el primer valor que no està en blanc o una cadena buida. Utilitzeu aquesta funció per substituir un valor en blanc o una cadena buida per un valor diferent, però no canvieu els valors que no estiguin en blanc ni les cadenes que no estiguin buides. Si tots els arguments són cadenes en blanc o buides, llavors la funció torna en blanc, fent Coalesce una bona manera de convertir cadenes buides en valors en blanc .

Coalesce( value1, value2 ) és l'equivalent més concís i If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) no requereix que value1 i value2 s'avaluïn dues vegades. La funció If retorna en blanc si no hi ha cap fórmula "else" com és el cas aquí.

Tots els arguments han Coalesce de ser del mateix tipus; per exemple, no es poden barrejar números amb cadenes de text. El valor de retorn de és d'aquest Coalesce tipus comú.

IsEmpty

La IsEmpty funció prova si una taula conté registres. És l'equivalent d'utilitzar la funció CountRows i comprovar si és zero. Podeu comprovar si hi ha errors de la font de dades combinant-los IsEmpty amb la funció Errors .

El valor retornat per IsEmpty és un booleà true o false.

Sintaxi

Blank()

Coalesce( Valor1 [, Valor2, ... ] )

• Valors : obligatori. Valors que es provaran. Cada valor s'avalua en ordre fins que es troba un valor que no estigui en blanc ni una cadena buida. Els valors posteriors a aquest punt no s'avaluen.

IsBlank( Valor )

• Valor : obligatori. Valor que es provarà si és un valor en blanc o una cadena buida.

IsEmpty( Taula )

• Taula : obligatòria. Taula on es provaran els registres.

Exemples

Blank

1. Creeu una aplicació des de zero i afegiu un control Botó.

2. Definiu la propietat OnSelect del botó a aquesta fórmula:

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

3. Feu una visualització prèvia de l'aplicació, feu clic o toqueu el botó que heu afegit i, a continuació, tanqueu la visualització prèvia.

4. Al menú Fitxer, feu clic o toqueu Col·leccions.

   Apareix la col·lecció Ciutats, que mostra un registre amb "Seattle" i "Plujós":

   

5. Feu clic o toqueu la fletxa enrere per tornar a l'àrea de treball per defecte.

6. Afegiu un control Etiqueta i definiu-ne la propietat Text en aquesta fórmula:

   IsBlank( First( Cities ).Weather )
   

   L'etiqueta mostra false perquè el camp Temps conté un valor ("Plujós").

7. Afegiu un segon botó i definiu-ne la propietat OnSelect a aquesta fórmula:

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

8. Feu una visualització prèvia de l'aplicació, feu clic o toqueu el botó que heu afegit i, a continuació, tanqueu la visualització prèvia.

   El camp Temps del primer registre Ciutats se substitueix per en blanc, fet que elimina l'element "Plujós" que hi era anteriorment.

   

   L'etiqueta mostra true perquè el camp Temps ja no conté cap valor.

Coalesce

Fórmula	Descripció	Resultat
Coalesce( Blank(), 1 )	Prova el valor de retorn de la Blank funció, que sempre retorna un valor en blanc . Com que el primer argument està en blanc, l' avaluació continua amb l'argument següent fins que es troba un valor que no estigui en blanc i una cadena que no estigui buida.	1
Coalesce( "", "2" )	Prova el primer argument, que és una cadena buida. Com que el primer argument és una cadena buida, l' avaluació continua amb l'argument següent fins que es troba un valor que no estigui en blanc i una cadena que no estigui buida.	2
Coalesce( Blank(), "", Blank(), "", "3", "4" )	Coalesce comença al principi de la llista d'arguments i avalua cada argument al seu torn fins que es troba un valor no en blanc i una cadena no buida. En aquest cas, els primers quatre arguments tots tornen un valor en blanc o una cadena buida, de manera que l'avaluació continua amb el cinquè argument. El cinquè argument és un valor que no està en blanc i una cadena que no està buida; per tant, l'avaluació s'atura aquí. Es torna el valor del cinquè argument i no s'avalua el sisè argument.	3
Coalesce( "" )	Prova el primer argument, que és una cadena buida. Com que el primer argument és una cadena buida i no hi ha més arguments, la funció torna en blanc.	Buit

IsBlank

1. Creeu una aplicació des de zero, afegiu-hi un control d'entrada de text i anomeneu-lo FirstName.

2. Afegiu una etiqueta i definiu-ne la propietat Text en aquesta fórmula:

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

   Per defecte, la propietat Text d'un control d'entrada de text està definida com a "Entrada de text". Com que la propietat conté un valor, no està en blanc i l'etiqueta no mostra cap missatge.

3. Suprimiu tots els caràcters del control d'entrada de text, inclòs qualsevol espai.

   Com que la propietat Text ja no conté cap caràcter, és una cadena buida i IsBlank( FirstName.Text ) és true. Es mostra el missatge de camp obligatori.

Per obtenir informació sobre com dur a terme la validació mitjançant altres eines, vegeu la funció Validate i Treballar amb fonts de dades.

Altres exemples:

Fórmula	Descripció	Resultat
IsBlank( Blank() )	Prova el valor de retorn de la Blank funció, que sempre retorna un valor en blanc .	veritable
IsBlank( "" )	Cadena que no conté caràcters.	veritable
IsBlank( "Hola" )	Cadena que conté un o més caràcters.	fals
IsBlank( Qualsevol col·lecció )	Com que la col·lecció existeix, no està en blanc, fins i tot si no conté cap registre. Per comprovar si hi ha una col·lecció buida, utilitzeu-la IsEmpty .	fals
IsBlank( Mig ( "Hola", 17, 2 ) )	El caràcter d'inici per a Mid és fora del final de la cadena. El resultat és una cadena buida.	veritable
IsBlank( Si ( fals, fals ) )	Una funció If sense ElseResult. Com que la condició sempre és false, If sempre torna en blanc.	veritable

IsEmpty

1. Creeu una aplicació des de zero i afegiu un control Botó.

2. Definiu la propietat OnSelect del botó a aquesta fórmula:

   Collect( Gelat, {Sabor: "Maduixa", Quantitat: 300}, {Sabor: "Xocolata", Quantitat: 100} )

3. Feu una visualització prèvia de l'aplicació, feu clic o toqueu el botó que heu afegit i, a continuació, tanqueu la visualització prèvia.

   Es crea una col·lecció anomenada Gelat i conté aquestes dades:

   

   Aquesta col·lecció té dos registres i no està buida. IsEmpty( IceCream ) retorna false i CountRows( IceCream ) retorna 2.

4. Afegiu un segon botó i definiu-ne la propietat OnSelect a aquesta fórmula:

   Clar ( Gelat )

5. Feu una visualització prèvia de l'aplicació, feu clic o toqueu el segon botó i, a continuació, tanqueu la visualització prèvia.

   La col·lecció ja està buida:

   

   La funció Clear suprimeix tots els registres d'una col·lecció, cosa que resulta en una col·lecció buida. IsEmpty( IceCream ) retorna true i CountRows( IceCream ) retorna 0.

També podeu utilitzar IsEmpty per comprovar si una taula calculada està buida, com es mostren en aquests exemples:

Fórmula	Descripció	Resultat
IsEmpty( [ 1, 2, 3 ] )	La taula d'una sola columna conté tres registres i, per tant, no està buida.	fals
IsEmpty( [ ] )	La taula d'una sola columna no conté cap registre i està buida.	veritable
IsEmpty( Filtre( [ 1, 2, 3 ], Valor > 5 ) )	La taula d'una sola columna no conté valors majors que 5. El resultat del filtre no conté cap registre i està buit.	veritable