Nz, functie

Gebruik de functie Nz om nul, een tekenreeks met lengte 0 (" ") of een andere opgegeven waarde te retourneren wanneer een Variant Null is. U kunt deze functie bijvoorbeeld gebruiken om een Null-waarde te converteren naar een andere waarde en te voorkomen dat de waarde wordt doorgegeven via een expressie.

Syntaxis

Nz ( variant [, waardealsnull ] )

De syntaxis van de functie Nz bevat de volgende argumenten:

Argument

Beschrijving

variant

Vereist. Een variabele van het gegevenstype Variant.

waardealsnull

Optioneel (tenzij gebruikt in een query). Een variant waarmee een waarde wordt geleverd die als resultaat moet worden gegevens als het argument variant de waarde Null heeft. Met behulp van dit argument kunt u een andere waarde dan nul of een tekenreeks met lengte nul als resultaat geven.

Opmerking : Als u de functie Nz gebruikt in een expressie in een query zonder het argument waardealsnull te gebruiken, resulteert dit in een tekenreeks met lengte nul in de velden die waarden null bevatten.


Als de waarde van het argument variantNull is, retourneert de functie Nz het getal nul of een tekenreeks met lengte nul (altijd een tekenreeks met lengte nul bij gebruik in een query-expressie). Het resultaat is afhankelijk van de context, waar wordt aangegeven of de waarde een getal of een tekenreeks moet zijn. Als het optionele argument waardealsnull is opgegeven, retourneert de functie Nz de waarde die is opgegeven met dat argument als het argument variant is ingesteld op Null. Als u de functie NZ gebruikt in een query-expressie, is het argument waardealsnull verplicht.

Als de waarde van variant niet Null is, retourneert Nz de waarde van variant.

Opmerkingen

De functie Nz is handig voor expressies die Null-waarden kunnen bevatten. Als het resultaat van een expressie niet Null moet zijn, zelfs niet wanneer deze een Null-waarde bevat, gebruikt u de functie Nz om nul, een tekenreeks met lengte nul of een aangepaste retourwaarde te retourneren.

De expressie 2 + varX levert bijvoorbeeld altijd een Null-waarde op wanneer Variant varXNull is. 2 + Nz(varX) daarentegen resulteert in 2.

De functie Nz kan vaak worden gebruikt als een alternatief voor de functie IIf. In de volgende code zijn bijvoorbeeld twee expressies met de functie IIf nodig om het gewenste resultaat te krijgen. De eerste expressie met de functie IIf is nodig om de waarde van een variabele te controleren en deze te converteren naar nul als de variabele Null is.

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

In het volgende voorbeeld biedt de functie Nz dezelfde functionaliteit als de eerste expressie en wordt het gewenste resultaat met één stap bereikt in plaats van twee.

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

Als u een waarde opgeeft voor het optionele argument waardealsnull, wordt die waarde geretourneerd wanneer variantNull is. Met behulp van dit optionele argument is het misschien niet nodig om een expressie te gebruiken met daarin de functie IIf. In de volgende expressie wordt de functie IIf bijvoorbeeld gebruikt om een tekenreeks te retourneren als de waarde van varFreightNull is.

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

In het volgende voorbeeld bevat het optionele argument voor de functie Nz de tekenreeks die moet worden geretourneerd als varFreightNull is.

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

Voorbeeld

Opmerking : In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Meer informatie over het werken met VBA vindt u door in de vervolgkeuzelijst naast Zoeken de optie Referentie voor ontwikkelaars te selecteren en een of meer termen in het zoekvenster te typen.

In het volgende voorbeeld wordt een besturingselement op een formulier geëvalueerd en bestaat het resultaat uit één van twee mogelijke tekenreeksen, afhankelijk van de waarde van het besturingselement. Als de waarde van het besturingselement Null is, wordt de functie Nz gebruikt om een Null-waarde te converteren naar een tekenreeks met lengte nul.

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
Uw vaardigheden uitbreiden
Training verkennen
Als eerste nieuwe functies krijgen
Deelnemen aan Office Insiders

Was deze informatie nuttig?

Bedankt voor uw feedback.

Hartelijk dank voor uw feedback! Het lijkt ons een goed idee om u in contact te brengen met een van onze Office-ondersteuningsagents.

×