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
Vigência | Definição |
---|---|
value |
Qualquer valor ou expressão. |
value_if_error |
Qualquer valor ou expressão. |
Valor de retorno
Um escalar do mesmo tipo que value
Comentários
Você pode usar a função IFERROR para intercetar e manipular erros em uma expressão.
Se
value
ouvalue_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 IF 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 paravalue_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 o 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)