Função Nz

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar a função Nz para retornar zero, uma cadeia de comprimento zero (""), ou em outra especificado valor quando uma variante é nulo. Por exemplo, você pode usar esta função para converter um valor Nulo em outro valor e impedir a propagar por meio de uma expressão.

Sintaxe

Nz ( variante [, valueifnull ] )

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

Argumento

Descrição

variante

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

valorseénulo

Opcional (a menos que seja usado em uma consulta). Um Variant que fornece um valor a ser retornado se o argumento variant for Nulo. Esse argumento permite que você retorne um valor diferente de zero ou uma cadeia de comprimento zero.

Observação : Se você usar a função Nz em uma expressão de uma consulta sem usar o argumento valueifnull, os resultados serão uma cadeia de comprimento zero nos campos que contiverem valores nulos.


Se o valor do argumento Variante for Nulo, a função Nz retornará o número zero ou uma cadeia de comprimento zero (sempre retorna uma cadeia de comprimento zero quando usada em uma expressão de consulta), dependendo se o contexto indica se o valor deve ser um número ou uma cadeia de caracteres. Se o argumento valorseénulo opcional for incluído, então a função Nz retornará o valor especificado por esse argumento, se o argumento variante for Nulo. Quando usada em uma expressão de consulta, a função NZ sempre deve incluir o argumento valorseénulo,

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

Comentários

A função Nz é útil em expressões que possam incluir valores Nulo. Para forçar uma expressão a ser avaliada como um valor não Nulo mesmo quando contém um valor Nulo, use a função Nz para retornar zero, uma cadeia de comprimento zero ou um valor de retorno personalizado.

Por exemplo, a expressão 2 + varX sempre retornará um valor Nulo quando a Variante varX for Nulo. No entanto, 2 + Nz(varX) retornará 2.

Você também pode usar a função Nz como uma alternativa para a função IIf. Por exemplo, no código a seguir, duas expressões que incluam a função IIf são necessárias para retornar o resultado desejado. A primeira expressão incluindo a função IIf é usada para verificar o valor de uma variável e convertê-la em zero se for Nulo.

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

No próximo exemplo, a função Nz oferece a mesma funcionalidade que a primeira expressão, e o resultado desejado é alcançado em uma etapa em vez de duas.

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

Se você fornecer um valor para o argumento opcional valorseénulo, esse valor será retornado quando a variante for Nulo. Incluindo esse argumento opcional, você poderá evitar o uso de uma expressão que contém a função IIf. Por exemplo, a expressão a seguir usa a função IIf para retornar uma cadeia de caracteres se o valor de varFreight for Nulo.

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

No próximo exemplo, o argumento opcional fornecido à função Nz fornece a cadeia de caracteres a ser retornada se varFreight for Nulo.

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

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

O exemplo a seguir avalia um controle em um formulário e retorna uma de duas cadeias de caracteres com base no valor do controle. Se o valor do controle for Nulo, o procedimento usará a função Nz para converter um valor Nulo em uma 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

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×