Partilhar via


Função IsNull

Retorna um valor Boolean que indica se uma expressão não contém dados válidos (Null).

Sintaxe

IsNull(expressão)

O argumento de expressão necessário é uma Variante que contém uma expressão numérica ou uma expressão de cadeia.

Comentários

IsNull retorna True se a expressão for Null; caso contrário, IsNull retorna False. Se a expressão consiste em mais de um variável, Null em qualquer variável constituinte causa o retorno de True para a expressão inteira.

O valor Null indica que a Variant não contém dados válidos. Null não é igual a Vazio, que indica que uma variável ainda não foi inicializada. Também não é o mesmo que uma cadeia de comprimento zero (""), que por vezes é referida como uma cadeia nula.

Importante

Use a função IsNull para determinar se uma expressão contém um valor Null. Expressões que se poderia esperar que o resultado da avaliação fosse True em algumas circunstâncias, como If Var = Null e If Var <> Null, são sempre False. Isso ocorre porque qualquer expressão que contenha Null em si mesma é Null e, portanto False.

Exemplo

Este exemplo usa a função IsNull para determinar se uma variável contém Null.

Dim MyVar, MyCheck
MyCheck = IsNull(MyVar)    ' Returns False.

MyVar = ""
MyCheck = IsNull(MyVar)    ' Returns False.

MyVar = Null
MyCheck = IsNull(MyVar)    ' Returns True.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.