Partilhar via


IFERROR

Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual

Avalia uma expressão e retorna um valor especificado se a expressão retornar um erro; caso contrário, retorna o valor da própria expressão.

Sintaxe

IFERROR(value, value_if_error)  

Parâmetros

Termo Definição
valor Qualquer valor ou expressão.
value_if_error Qualquer valor ou expressão.

Valor devolvido

Um escalar do mesmo tipo que o valor

Observações

  • Você pode usar a função IFERROR para intercetar e manipular erros em uma expressão.

  • Se value ou value_if_error for uma célula vazia, IFERROR a tratará como um valor de cadeia de caracteres vazia ("").

  • A função IFERROR é baseada na função IF e usa as mesmas mensagens de erro, mas tem menos argumentos. A relação entre a função IFERROR e a função SE da seguinte forma:

    IFERROR(A,B) := IF(ISERROR(A), B, A)

    Os valores retornados para A e B devem ser do mesmo tipo de dados; Portanto, a coluna ou expressão usada para Value e o valor retornado para value_if_error devem ser do mesmo tipo de dados.

  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

  • Para obter as práticas recomendadas ao usar IFERROR, consulte Uso apropriado de funções de erro.

Exemplo

O exemplo a seguir retorna 9999 se a expressão 25/0 for avaliada como um erro. Se a expressão retornar um valor diferente de error, esse valor será passado para a expressão que invoca.

= IFERROR(25/0,9999)  

Funções lógicas