Testa se um valor está em branco ou se uma tabela não contém nenhum registro e fornece uma maneira de criar valores em branco.

Visão geral

Em branco é um espaço reservado para "nenhum valor" ou "valor desconhecido". Um controle Entrada de dados fica blank se o usuário não digitou nenhum caractere nele. O mesmo controle não estará mais em branco assim que o usuário digitar um caractere. Algumas fontes de dados podem armazenar e retornar valores NULL, que são representados no PowerApps como blank.

Observação: no momento, somente há suporte para o armazenamento de valores blank em coleções locais. Sabemos que várias fontes de dados dão suporte a valores blank (NULL) e estamos trabalhando para reduzir essa limitação.

Qualquer propriedade ou valor calculado pode estar em branco. Por exemplo, um valor booliano normalmente tem um dos dois valores: true ou false. Mas, além desses dois, ele também pode estar em branco. Isso é semelhante ao Microsoft Excel, em que uma célula de planilha começa em branco, mas pode conter os valores TRUE ou FALSE, entre outros. A qualquer momento, o conteúdo da célula pode ser removido e ele retornaria para um estado em branco.

Vazio é específico para tabelas que não contêm nenhum registro. A estrutura da tabela pode estar intacta, completo com nomes de coluna, mas nenhum dado está na tabela. Uma tabela pode ser iniciada como vazia, utilizar registros e não estar mais vazia e, em seguida, os registros podem ser removidos e ela ficar novamente vazia.

Descrição

A função Blank retorna um valor blank. Use isso para armazenar um valor NULL em uma fonte de dados que dá suporte a esses valores, removendo efetivamente qualquer valor do campo.

A função IsBlank testa um valor em branco. Valores em branco são encontrados em situações como estas:

  • O valor retornado da função Blank.
  • Uma propriedade de controle sem uma fórmula definida para ela.
  • Nenhum valor é digitado em um controle de entrada de texto ou nenhuma seleção é feita em uma caixa de listagem. Você pode usar IsBlank para fornecer comentários de que um campo é obrigatório.
  • Uma cadeia de caracteres que não contém caracteres tem um Len de 0.
  • Ocorreu um erro em uma função. Geralmente, um dos argumentos para a função não era válido. Muitas funções retornarão em branco se o valor de um argumento estiver em branco.
  • Fontes de dados conectadas, como SQL Server, podem usar valores "nulos". Esses valores são exibidos em branco no PowerApps.
  • A parte else de uma função If não foi especificada e todas as condições eram false.
  • Você usou a função Atualizar, mas não especificou um valor para todas as colunas. Como resultado, nenhum valor foi colocado nas colunas que não foram especificadas.

A função Coalesce avalia seus argumentos na ordem e retorna o primeiro valor que não é em branco. Use essa função para substituir um valor em branco por um valor diferente, mas deixar os valores que não são em branco inalterados. Se todos os argumentos forem em branco, a função retornará em branco. Todos os argumentos de Coalesce devem ser do mesmo tipo; por exemplo, não é possível combinar números com cadeias de texto. Coalesce( value1, value2 ) é o equivalente mais conciso de If( IsBlank( value1 ) value1, value2 ) e não exige que value1 seja avaliado duas vezes.

A função IsEmpty testa se uma tabela contém algum registro. É equivalente a usar a função CountRows e a verificação de zero. Você pode verificar se há erros na fonte de dados combinando IsEmpty com a função Errors.

O valor retornado para IsBlank e IsEmpty é um true ou false booliano.

Sintaxe

Blank()

Coalesce( Value1 [, Value2, ... ] )

  • Value(s) – obrigatório. Valores a serem testados. Cada valor é avaliado na ordem, até que um valor não em branco seja encontrado. Os valores após o primeiro valor não em branco não são avaliados.

IsBlank( Value )

  • Valor – Obrigatório. Valor a ser testado.

IsEmpty( Table )

  • Table – Obrigatório. Tabela a ser testada quanto a registros.

Exemplos

Blank

OBSERVAÇÃO: no momento, o exemplo a seguir funciona somente em coleções locais. Sabemos que várias fontes de dados dão suporte a valores blank (NULL) e estamos trabalhando para reduzir essa limitação.

  1. Crie um aplicativo do zero e adicione um controle de Botão.

  2. Defina a propriedade OnSelect do botão como esta fórmula:

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

  3. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

  4. No menu Arquivo, clique ou toque em Coleções.

    A coleção Cities é exibida, mostrando um registro com “Seattle” e “Rainy”:

    Coleção mostrando Seattle com o clima Rainy

  5. Clique ou toque na seta para voltar para retornar ao espaço de trabalho padrão.

  6. Adicione um controle Rótulo e defina sua propriedade Text com esta fórmula:

    IsBlank( First( Cities ).Weather )

    O rótulo mostra false porque o campo Weather contém um valor (“Rainy”).

  7. Adicione um segundo botão e defina sua propriedade OnSelect com esta fórmula:

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

  8. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

    O campo Weather do primeiro registro de Cities é substituído por um blank, removendo “Rainy” que estava no campo.

    Coleção mostrando Seattle com um campo Weather em branco

    O rótulo mostra true porque o campo Weather não contém mais um valor.

Coalesce

Fórmula Descrição Resultado
Coalesce( Blank(), 1 ) Testa o valor retornado da função Blank, que sempre retorna um valor blank. Como o primeiro argumento é em branco, a avaliação continua com o próximo argumento, até que um valor não em branco seja encontrado. 1
Coalesce( Blank(), Blank(), Blank(), Blank(), 2, 3 ) Coalesce começa no início da lista de argumentos e avalia cada argumento por vez, até que um valor não em branco seja encontrado. Nesse caso, todos os quatro primeiros argumentos retornam em branco e, portanto, a avaliação continua com o quinto argumento. Como o quinto argumento não é em branco, a avaliação para aqui. O valor do quinto argumento é retornado e o sexto argumento não é avaliado. 2

IsBlank

  1. Crie um aplicativo do zero, adicione um controle de entrada de texto e nomeie-o FirstName.

  2. Adicione um rótulo e defina sua propriedade Text como esta fórmula:

    If( IsBlank( FirstName.Text ), "Nome é um campo obrigatório." )

    Por padrão, a propriedade Text de um controle de entrada de texto é definida como “Entrada de texto”. Como a propriedade contém um valor, ela não está em branco e o rótulo não exibe nenhuma mensagem.

  3. Remova todos os caracteres do controle de entrada de texto, incluindo os espaços.

    Como a propriedade Text não contém mais nenhum caractere, ela está blank e IsBlank( FirstName.Text ) será true. Será exibida a mensagem de campo obrigatório.

Para obter informações sobre como realizar a validação usando outras ferramentas, consulte a função Validate e Trabalhando com fontes de dados.

Outros exemplos:

Fórmula Descrição Resultado
IsBlank( Blank() ) Testa o valor retornado da função Blank, que sempre retorna um valor blank. verdadeiro
IsBlank( "" ) Uma cadeia de caracteres que não contém caracteres. true
IsBlank( "Hello" ) Uma cadeia de caracteres que contém um ou mais caracteres. false
IsBlank( AnyCollection ) Como a coleção existe, ela não está em branco, mesmo não contendo nenhum registro. Para buscar uma coleção vazia, use IsEmpty em vez disso. false
IsBlank( Mid( "Hello", 17, 2 ) ) O caractere inicial de Mid está além do fim da cadeia de caracteres. O resultado é uma cadeia de caracteres vazia. true
IsBlank( If( false, false ) ) Uma função If sem nenhum ElseResult. Como a condição é sempre false, esse If sempre retorna em branco. true

IsEmpty

  1. Crie um aplicativo do zero e adicione um controle de Botão.

  2. Defina a propriedade OnSelect do botão como esta fórmula:

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

  3. Visualize o aplicativo, clique ou toque no botão que você adicionou e, em seguida, feche Visualizar.

    Uma coleção chamada IceCream é criada e ela contém estes dados:

    Essa coleção tem dois registros e não está vazia. IsEmpty( IceCream ) retorna false e CountRows( IceCream ) retorna 2.

  4. Adicione um segundo botão e defina sua propriedade OnSelect com esta fórmula:

    Clear( Sorvete )

  5. Visualize o aplicativo, clique ou toque no segundo botão e, em seguida, feche Visualizar.

    A coleção agora está vazia:

    A função Limpar remove todos os registros de uma coleção, resultando em uma coleção vazia. IsEmpty( IceCream ) retorna true e CountRows( IceCream ) retorna 0.

Você também pode usar IsEmpty para testar se uma tabela calculada está vazia, como mostram os exemplos:

Fórmula Descrição Resultado
IsEmpty( [ 1, 2, 3 ] ) A tabela de coluna única contém três registros e, portanto, não está vazia. false
IsEmpty( [ ] ) A tabela de coluna única não contém nenhum registro e está vazia. true
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) ) A tabela de coluna única não contém nenhum valor maior que 5. O resultado do filtro não contém nenhum registro e está vazio. true