Testa se um valor está em branco ou se uma tabela não contém nenhum registro.

Visão geral

Em branco é um espaço reservado para "nenhum valor" ou "valor desconhecido". Uma caixa de texto de entrada ficará em branco se o usuário não digitar nenhum caractere nela. O mesmo controle não estará mais em branco assim que o usuário digitar um caractere.

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 IsBlank testa um valor em branco. Valores em branco são encontrados em situações como estas:

  • Uma propriedade de controle sem uma fórmula definida para ela.
  • Nenhum valor estiver digitado em um controle de texto de entrada ou nenhuma seleção for 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 colocados nas colunas que você não especificou.

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 usar IsEmpty para buscar erros de fonte de dados, combinando com a função Erros.

O valor retornado para ambas as funções é um valor booliano true ou false.

Sintaxe

IsBlank( Value )

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

IsEmpty( Table )

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

Exemplos

IsBlank

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

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

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

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

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

    Como o controle não contém mais nenhum caractere, sua propriedade de Texto será em branco e IsBlank( FirstName.Text ) será true. Será exibida a mensagem de campo obrigatório.

Você pode executar a validação usando outras ferramentas. Consulte a função Validar e trabalhando com fontes de dados.

Outros exemplos:

Fórmula Descrição Resultado
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. Criar uma coleção denominada IceCream, definindo a propriedade OnSelect de um botão como esta fórmula e, em seguida, pressionando o botão:

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

    A coleção contém estes dados:

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

  2. Esvazie a coleção alterando a propriedade OnSelect de um botão para esta fórmula e, em seguida, pressionando o botão:

    Clear( IceCream )

    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