Função IsNull

Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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

Sintaxe

IsNull(expression)

O argumento de expressãonecessária é uma Variant que contém uma expressão numérica ou expressão de cadeia de caracteres.

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 uma variável, Null em qualquer variável constituinte fará com que True seja retornado para toda a expressão.

O valor Null indica que a Variant não contém dados válidos. Null não é o mesmo que Vazio, o que indica que uma variável ainda não foi inicializada. Ele também não é o mesmo que uma cadeia de caracteres de comprimento zero (""), que às vezes é chamada de cadeia de caracteres nula.

Importante

Use a função IsNull para determinar se uma expressão contém um valor Nulo . Expressões que você pode esperar avaliar como 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 um Null é em si Null e, portanto, False.

Exemplos de consulta

Expressão. Resultados
SELECT ProductID, isNull(Discount) AS Expr1 FROM ProductSales; Retorna valores do campo "ProductID", avalia se os valores no campo "Desconto" são Null, retorna -1 (True) e 0 (False) na coluna Expr1.
SELECT ProductID, isNull(Discount) AS NullStatus FROM ProductSales; Retorna valores do campo "ProductID", avalia se os valores no campo "Desconto" são Null, retorna -1 (True) e 0 (False) na coluna NullStatus.

Exemplo de VBA

Observação

Este exemplo demonstra o uso dessa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

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


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