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 VariantNullis, retourneert de functie Nz de waarde nul of een tekenreeks met lengte nul of een tekenreeks met lengte nul (altijd een tekenreeks met de lengte nul als resultaat wanneer deze wordt gebruikt in een query-expressie), afhankelijk van of de context de waarde aangeeft moet een getal of een tekenreeks zijn. Als het argument optional waardealsnull is opgenomen, retourneert de functie Nz de waarde die door dit argument is opgegeven als het argument Variant Nullis. Wanneer in een query-expressie wordt gebruikt, moet de functie Nz altijd het argument waardealsnull bevatten.

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")

Query voorbeelden

Expressie

Resultaten

Selecteer product-id, NZ (korting, geen detail beschikbaar) als Expr2 van ProductSales;

Retourneert "product-id" in kolom Expr1, evalueert de waarden van Null in het veld "korting" en geeft als resultaat "geen details beschikbaar" voor alle Null-waarden (geeft de niet-Null-waarden als resultaat).

SELECT product-id, NZ (korting, "geen detail beschikbaar") als ReplaceNull van ProductSales;

Geeft als resultaat "product-id" in kolom product, evalueert de Null-waarden in het veld "korting" en geeft als resultaat "geen gegevens beschikbaar" voor alle Null-waarden (geeft de niet-Null-waarden als resultaat) en worden weergegeven in kolom ReplaceNull.

Voorbeeld van VBA

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

Opmerking:  Deze pagina is automatisch vertaald en kan grammaticale fouten of onnauwkeurigheden bevatten. Wij hopen dat deze inhoud nuttig voor je is. Wil je ons laten weten of deze informatie nuttig is? Hier is het Engelstalige artikel ter referentie.

Uw Office-vaardigheden uitbreiden
Training verkennen
Als eerste nieuwe functies krijgen
Deelnemen aan Office Insiders