Ir diretamente para o conteúdo principal

IsNull

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

Estrutura

IsNull(expressão)

Parâmetros

O argumento «expressão» pode ser qualquer expressão.

Descrição

A função IsNull devolve True se a expressão for nula, ou seja, se não contiver dados válidos; caso contrário, a função IsNull devolve False. Se a expressão for composta por mais do que uma variável, o valor Null em qualquer uma das variáveis que a compõem faz com que seja devolvido o valor True para toda a expressão.

O valor nulo indica que a variável não contém dados válidos. Null não é o mesmo que Empty, que indica que uma variável ainda não foi inicializada. Também não é o mesmo que uma cadeia de caracteres de comprimento zero (''), que por vezes é designada por cadeia nula.

Atenção

Utilize a função IsNull para determinar se uma expressão contém um valor nulo. Expressões que se poderia esperar que resultassem em True em determinadas circunstâncias, tais como «If Var = Null» e «If Var <> Null», resultam sempre em False.

Isto acontece porque qualquer expressão que contenha um valor nulo é, ela própria, nula e, por conseguinte, falsa.

Exemplo

O exemplo seguinte utiliza a função IsNull para determinar se uma variável contém um valor nulo:

Dim MyVar, MyCheck

MyCheck = IsNull(MyVar) ' Devolve False.

MyVar = Null ' Atribui o valor Null.

MyCheck = IsNull(MyVar) ' Retorna True.

MyVar = Empty ' Atribuir o valor Empty.

MyCheck = IsNull(MyVar) ' Retorna False. |