Blank, Coalesce, IsBlanke funcións IsEmpty

Funcións	Aplícase a
Blank	Aplicacións de lenzo Copilot Studio Fluxos de escritorio Columnas de fórmulas de Dataverse Aplicacións baseadas en modelos Power Platform CLI Funcións de Dataverse
Coalesce IsEmpty	Aplicacións de lenzo Copilot Studio Fluxos de escritorio Aplicacións baseadas en modelos Power Platform CLI Dataverse funcións Power Pages
IsBlank	Aplicacións de lenzo Copilot Studio Fluxos de escritorio Columnas de fórmulas de Dataverse Aplicacións baseadas en modelos Power Platform CLI Funcións de Dataverse Power Pages

Comproba se un valor está baleiro ou unha táboa non contén rexistros e fornece unha forma de crear valores en branco.

Visión xeral

Blanké un marcador de posición para "ningún valor" ou "valor descoñecido". Por exemplo, a propiedade Selected dun control de caixa combinada está en branco se o usuario non fixo unha selección. Moitas fontes de datos poden almacenar e devolver valores NULOS, representados en Power Apps como en branco.

Calquera propiedade ou valor calculado en Power Apps pode estar en branco. Por exemplo, un valor booleano normalmente ten un dos dous valores: verdadeiro ou falso. Pero ademais destes dous, tamén pode estar en branco indicando que o estado non se coñece. Isto é semellante a Microsoft Excel, onde unha cela dunha folla de traballo comeza en branco sen contidos pero pode manter os valores VERDADEIRO ou FALSO (entre outros). En calquera momento, pódese eliminar o contido da cela e devolvela ao estado en branco.

Cadea baleira refírese a unha cadea que non contén caracteres. A función Len devolve cero para tal cadea e pódese escribir en fórmulas como dúas comiñas dobres sen nada polo medio "". Algúns controis e fontes de datos usan unha cadea baleira para indicar unha condición "sen valor". Para simplificar a creación de aplicacións, as IsBlank funcións e Coalesce proban tanto valores en branco como cadeas baleiras.

No contexto da IsEmpty función, o baleiro é específico para as táboas que non conteñen rexistros. A estrutura da táboa pode estar intacta e completa con nomes de columna, pero non hai datos na táboa. Unha táboa pode comezar como baleira, asumir rexistros e deixar de estar baleira e, a continuación, que os rexistros sexan eliminados e de novo estar baleira.

Blank

A Blank función devolve un valor en branco . Use isto para almacenar un valor NULO nunha orixe de datos que admita estes valores, eliminando de xeito efectivo calquera valor do campo.

IsBlank

A IsBlank función proba un valor en branco ou unha cadea baleira. A proba inclúe cadeas baleiras para facilitar a creación de aplicacións, xa que algunhas fontes de datos e controis usan unha cadea baleira cando non hai ningún valor presente. Para probar especificamente un valor en branco , use if(Value = Blank(), ... en lugar de IsBlank. A IsBlank función considera as táboas baleiras como non en branco, e IsEmpty debe usarse para probar unha táboa.

Ao habilitar o manexo de erros para aplicacións existentes, considere substituír IsBlank por IsBlankOrError para preservar o comportamento da aplicación existente. Antes da adición do tratamento de erros, empregouse un valor en branco para representar tanto valores nulos das bases de datos como valores de erro. O manexo de erros separa estas dúas interpretacións de blank, o que podería cambiar o comportamento das aplicacións existentes que seguen a usar IsBlank.

O valor de retorno é IsBlank un booleano verdadeiro ou falso.

Coalesce

A Coalesce función avalía os seus argumentos en orde e devolve o primeiro valor que non está en branco ou unha cadea baleira. Use esta función para substituír un valor en branco ou unha cadea baleira cun valor diferente, pero deixe os valores non en branco e as cadeas non baleiras sen modificar. Se todos os argumentos son cadeas en branco ou baleiras, entón a función devolve en branco, o que fai Coalesce unha boa forma de converter as cadeas baleiras en valores en branco .

Coalesce( value1, value2 ) é o equivalente máis conciso de If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) e non require valor1 e valor2 para ser avaliado dúas veces. A función If devolve en branco se non hai unha fórmula "outra" como é o caso aquí.

Todos os argumentos deben Coalesce ser do mesmo tipo; por exemplo, non se poden mesturar números con cadeas de texto. O valor de retorno é Coalesce deste tipo común.

IsEmpty

A IsEmpty función comproba se unha táboa contén rexistros. É equivalente a usar a función CountRows e comprobar se hai cero. Pode comprobar se hai erros na fonte de datos combinando IsEmpty coa función Erros .

O valor de retorno é IsEmpty un booleano verdadeiro ou falso.

Sintaxe

Blank()

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

• Valores – Obrigatorio. Valores que se van comprobar. Cada valor avalíase en orde ata que se atope un valor que non estea en branco e non unha cadea baleira. Os valores posteriores a este punto non se avalía.

IsBlank( Valor )

• Valor – Obrigatorio. Valor para comprobar se hai un valor en branco ou cadea baleira.

IsEmpty( Táboa )

• Táboa - Obrigatorio. Táboa para comprobar se hai rexistros.

Exemplos

Blank

1. Cree unha aplicación desde cero e engada un control Botón.

2. Axuste a propiedade OnSelect do botón nesta fórmula:

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

3. Obteña a vista previa da súa aplicación, faga clic ou toque o botón que engadiu e logo peche a Vista previa.

4. No menú Ficheiro, prema ou toque Coleccións.

   A colección Cidades aparece, e mostran un rexistro con "Seattle" e "Chuvioso":

   

5. Faga clic ou toque a frecha cara atrás para volver ao espazo de traballo predeterminado.

6. Engada un control Etiqueta e configure a súa propiedade Text nesta fórmula:

   IsBlank( First( Cities ).Weather )
   

   A etiqueta mostra falso porque o campo Tempo contén un valor ("Chuvioso").

7. Engada un segundo botón e axuste a súa propiedade OnSelect nesta fórmula:

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

8. Obteña a vista previa da súa aplicación, faga clic ou toque o botón que engadiu e logo peche a Vista previa.

   O campo O tempo do primeiro rexistro en Cidades substitúese por en branco, e elimínase o valor "chuvioso" que había alí anteriormente.

   

   A etiqueta mostra verdadeiro porque o campo Tempo xa non contén un valor.

Coalesce

Fórmula	Descripción	Resultado
Coalesce( Blank( ), 1 )	Proba o valor devolto da Blank función, que sempre devolve un valor en branco . Dado que o primeiro argumento está en branco, a avaliación continúa co seguinte argumento ata que se topa un valor non en branco e unha cadea non baleira.	1
Coalesce( "", "2" )	Proba o primeiro argumento, que é unha cadea baleira. Dado que o primeiro argumento é unha cadea baleira, a avaliación continúa co seguinte argumento ata que se topa un valor non en branco e unha cadea non baleira.	2
Coalesce( Blank(), "", Blank(), "", "3", "4")	Coalesce Comeza ao comezo da lista de argumentos e avalía cada argumento á súa vez ata que se atopa un valor non en branco e unha cadea non baleira. Neste caso, os catro primeiros argumentos devolven en branco ou unha cadea baleira, polo que a avaliación continúa co quinto argumento. O quinto argumento non está en branco nin é unha cadea baleira, polo que a avaliación detense aquí. Devólvese o valor do quinto argumento e o sexto argumento non se avalía.	3
Coalesce( "" )	Proba o primeiro argumento, que é unha cadea baleira. Debido a que o primeiro argumento é unha cadea baleira, e non hai máis argumentos, a función devolve en branco.	en branco

IsBlank

1. Cree unha aplicación dende cero, engada un control de entrada de texto e noméeo FirstName.

2. Engada unha etiqueta e configure a súa propiedade Texto nesta fórmula:

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

   Por defecto, a propiedade Texto dun control de entrada de texto está definida en "Entrada de texto". Debido a que a propiedade contén un valor, non está en branco e na etiqueta non aparece ningunha mensaxe.

3. Elimine todos os caracteres do control de entrada de texto, incluídos os espazos.

   Debido a que a propiedade Text xa non contén caracteres, é unha cadea baleira e IsBlank( FirstName.Text ) é true. Móstrase a mensaxe de campo obrigatorio.

Para obter información sobre como realizar a validación usando outras ferramentas, consulte a función Validate e traballar con fontes de datos.

Outros exemplos:

Fórmula	Descripción	Resultado
IsBlank( Blank() )	Proba o valor devolto da Blank función, que sempre devolve un valor en branco .	verdade
IsBlank( "" )	Cadea que non contén caracteres.	verdade
IsBlank( "Ola")	Cadea que contén un ou varios caracteres.	falso
IsBlank( AnyCollection )	Como a colección existe, non está en branco, aínda que non conteña rexistros. Para comprobar se hai unha colección baleira, use IsEmpty no seu lugar.	falso
IsBlank( Mid ( "Ola", 17, 2 ) )	O carácter inicial de Mid está máis aló do final da cadea. O resultado é unha cadea baleira.	verdade
IsBlank( Se ( falso, falso ) )	Unha función If sen ElseResult. Como a condición é sempre false, ista función If sempre volve en branco.	verdade

IsEmpty

1. Cree unha aplicación desde cero e engada un control Botón.

2. Axuste a propiedade OnSelect do botón nesta fórmula:

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

3. Obteña a vista previa da súa aplicación, faga clic ou toque o botón que engadiu e logo peche a Vista previa.

   Unha colección chamada IceCream creouse e contén estes datos:

   

   Esta colección ten dous rexistros e non está baleira. IsEmpty( IceCream ) devolve false e CountRows( IceCream ) devolve 2.

4. Engada un segundo botón e axuste a súa propiedade OnSelect nesta fórmula:

   Borrar (Xeado)

5. Obteña a vista previa da súa aplicación, faga clic ou toque o segundo botón e logo peche a Vista previa.

   A colección está agora baleira:

   

   A función Clear elimina todos os rexistros dunha colección, obtendo unha colección baleira. IsEmpty( IceCream ) devolve true e CountRows( IceCream ) devolve 0.

Tamén podes usar IsEmpty para comprobar se unha táboa calculada está baleira, como mostran estes exemplos:

Fórmula	Descripción	Resultado
IsEmpty( [ 1, 2, 3 ] )	A táboa dunha única columna contén tres rexistros e, polo tanto, non está baleira.	falso
IsEmpty( [ ] )	A táboa dunha única columna non contén rexistros e está baleira.	verdade
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	A táboa dunha única columna non contén valores superiores a 5. O resultado do filtro non contén rexistros e está baleiro.	verdade