Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Pode utilizar a função Nz para devolver zero, uma cadeia de comprimento zero (" ") ou outro valor específico quando uma Variante é Nula. Por exemplo, pode utilizar esta função para converter um valor Nulo noutro valor e impedi-lo de propagar através de uma expressão.

Sintaxe

Nz ( variante [, valorsenulo ] )

A sintaxe da função Nz tem os seguintes argumentos:

Argumento

Descrição

variante

Obrigatório. Uma variável do tipo de dados Variante.

valorsenulo

Opcional (a menos que seja utilizado numa consulta). Uma Variante que fornece um valor a ser devolvido se o argumento da variante for Nulo. Este argumento permite-lhe devolver um valor diferente de zero ou uma cadeia de comprimento zero.

Nota: Se utilizar a função Nz numa expressão de uma consulta sem utilizar o argumento valorsenulo, os resultados serão uma cadeia de comprimento zero nos campos que contêm valores nulos.

Se o valor do argumento variante for Nulo, a função Nz devolve o número zero ou uma cadeia de comprimento zero (devolve sempre uma cadeia de comprimento zero quando utilizada numa consulta de expressão), dependendo se o contexto indica que o valor deve ser um número ou uma cadeia. Se o argumento opcional valorsenulo estiver incluído, então a função Nz devolverá o valor especificado por esse argumento se o argumento variante for Nulo. Quando utilizada numa consulta de expressão, a função NZ deve sempre incluir o argumento valorsenulo.

Se o valor de variante não for Nulo, então a função Nz devolve o valor de variante.

Observações

A função Nz é útil para expressões que possam incluir valores Nulos. Para forçar uma expressão a avaliar um valor não Nulo, mesmo quando este contém um valor Nulo, utilize a função Nz para devolver zero, uma cadeia de comprimento zero ou um valor devolvido personalizado.

Por exemplo, a expressão 2 + varX irá sempre devolver um valor Nulo quando a VariantevarX for Nula. No entanto, a expressão 2 + Nz(varX) devolve 2.

Muitas vezes, pode utilizar a função Nz como alternativa à função ISe. Por exemplo, no código seguinte, duas expressões que incluem a função ISe são necessárias para devolver o resultado pretendido. A primeira expressão que inclui a função ISe é utilizada para verificar o valor de uma variável e convertê-lo em zero se for Nulo.

varTemp = IIf(IsNull(varFreight), 0, varFreight)varResult = IIf(varTemp > 50, "High", "Low")

No exemplo seguinte, a função Nz disponibiliza a mesma funcionalidade da primeira expressão e o resultado pretendido é atingido num passo em vez de em dois.

varResult = IIf(Nz(varFreight) > 50, "High", "Low")

Se fornecer um valor para o argumento opcional valorsenulo, esse valor será devolvido quando o argumento variante for Nulo. Ao incluir este argumento opcional, poderá conseguir evitar a utilização da expressão que contém a função ISe. Por exemplo, a expressão seguinte utiliza a função ISe para devolver uma cadeia se o valor varFreight for Nulo.

varResult = IIf(IsNull(varFreight), _    "No Freight Charge", varFreight)

No exemplo seguinte, o argumento opcional fornecido à função Nz disponibiliza a cadeia para ser devolvida se o valor varFreight for Nulo.

varResult = Nz(varFreight, "No Freight Charge")

Exemplos de consulta

Expressão

Resultados

SELECT ProductID, NZ(Discount,"No Detail Available") AS Expr2 FROM ProductSales;

Devolve "IDDoProduto" na coluna Expr1, avalia os valores "Nulos" no campo "Desconto" e devolve "Sem Detalhes Disponíveis" para todos os valores Nulos (devolve os valores não nulos tal como estão).

SELECT ProductID, NZ(Discount,"No Detail Available") AS ReplaceNull FROM ProductSales;

Devolve "IDDoProduto" na coluna Produto, avalia os valores "Nulos" no campo "Desconto" e devolve "Sem Detalhes Disponíveis" para todos os valores Nulos (devolve os valores não nulos tal como estão) e é apresentado na coluna ReplaceNull.

Exemplo de VBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

O exemplo seguinte avalia um controlo num formulário e devolve uma de duas cadeias com base nos valores do controlo. Se o valor do controlo for Nulo, o processo utiliza a função Nz para converter um valor Nulo numa cadeia de comprimento zero.

Public Sub CheckValue()    Dim frm As Form    Dim ctl As Control    Dim varResult As Variant    ' Return Form object variable     ' pointing to Orders form.    Set frm = Forms!Orders    ' Return Control object variable     ' pointing to ShipRegion.    Set ctl = frm!ShipRegion    ' Choose result based on value of control.    varResult = IIf(Nz(ctl.Value) = vbNullString, _        "No value.", "Value is " & ctl.Value & ".")    ' Display result.    MsgBox varResult, vbExclamationEnd Sub

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.