Compartilhar via


IFERROR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Avalia uma expressão e retorna um valor especificado se a expressão retorna 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 retornado

Um escalar do mesmo tipo que value

Comentários

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

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

  • 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 é a seguinte:

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

    Os valores retornados para A e B devem ter o mesmo tipo de dados, portanto, a coluna ou a expressão usada para value e o valor retornado para value_if_error devem ter o mesmo tipo de dados.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

  • Para melhores práticas ao usar IFERROR, confira Uso adequado de funções de erro.

Exemplo

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

= IFERROR(25/0,9999)  

Funções lógicas