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 "ProductID" 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 como está).

SELECT ProductID, NZ (Discount"Sem detalhe disponível") AS ReplaceNull FROM ProductSales;

Devoluções "ProductID" 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 como está) e apresenta na coluna ReplaceNull.

Exemplo 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, vbExclamation
End Sub

Precisa de mais ajuda?

Aumente os seus conhecimentos

Explore as formações >

Seja o primeiro a obter novas funcionalidades

Aderir ao Microsoft insiders >

As informações foram úteis?

Quão satisfeito está com a qualidade do idioma?
O que afetou a sua experiência?

Obrigado pelo seu feedback!

×