Funkcia Nz

Funkciu Nz môžete použiť na vrátenie nuly, reťazca nulovej dĺžky (" ) alebo inej zadanej hodnoty, ak má variant hodnotu Null. Túto funkciu môžete použiť napríklad na skonvertovanie hodnoty Null na inú hodnotu a zabránenie jej rozšíreniu prostredníctvom výrazu.

Syntax

Nz(variant [, valueifnull ] )

Syntax funkcie Nz má tieto argumenty:

Argument	Popis
variant	Povinný argument. Premenná typu údajov Variant.
valueifnull	Voliteľné (ak sa nepoužíva v dotaze). Variant, ktorý poskytuje hodnotu, ktorá sa má vrátiť, ak má argument varianthodnotu Null. Tento argument umožňuje vrátiť hodnotu inú ako nula alebo reťazec s nulovou dĺžkou. Poznámka: Ak použijete funkciu Nz vo výraze v dotaze bez použitia argumentu valueifnull , výsledkom bude reťazec s nulovou dĺžkou v poliach obsahujúcich hodnoty null.

Ak je hodnota argumentu variantunull, funkcia Nz vráti číslo nula alebo reťazec s nulovou dĺžkou (vždy vráti reťazec s nulovou dĺžkou pri použití vo výraze dotazu) v závislosti od toho, či kontext označuje, že hodnota by mala byť číslo alebo reťazec. Ak je zahrnutý voliteľný argument valueifnull , funkcia Nz vráti hodnotu určenú týmto argumentom, ak má argument varianthodnotu Null. Pri použití vo výraze dotazu by funkcia NZ mala vždy obsahovať argument valueifnull ,

Ak hodnota variantu nie je Null, funkcia Nz vráti hodnotu variantu.

Poznámky

Funkcia Nz je užitočná pre výrazy, ktoré môžu zahŕňať hodnoty Null. Ak chcete donútiť výraz k tomu, aby sa vyhodnotil ako hodnota iná než Null aj vtedy, keď obsahuje hodnotu Null, použite na vrátenie nuly, reťazca s nulovou dĺžkou alebo vlastnej vrátenej hodnoty funkciu Nz.

Napríklad výraz 2 + varX vždy vráti hodnotu Null , keď má variantvarXhodnotu Null. Vráti však 2 + Nz(varX) číslo 2.

Funkciu Nz je často možné použiť ako alternatívu k funkcii IIf. Napríklad na vrátenie požadovaného výsledku sú v nasledujúcom kóde potrebné dva výrazy obsahujúce funkciu IIf. Prvý výraz obsahujúci funkciu IIf sa použije na kontrolu hodnoty premennej a ak je hodnota Null, tak aj na jej konvertovanie na nulu.

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

V nasledujúcom príklade funguje funkcia Nz rovnako ako prvý výraz a na dosiahnutie požadovaného výsledku stačí jeden, nie dva kroky.

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

Po zadaní hodnoty pre voliteľný argument valueifnull sa v prípade, že argument variant má hodnotu Null, daná hodnota vráti. Pri použití voliteľného argumentu je možné vyhnúť sa použitiu výrazu obsahujúceho funkciu IIf. Nasledujúci výraz napríklad používa funkciu IIf na vrátenie reťazca, ak je hodnota varFreightnull.

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

V nasledujúcom príklade voliteľný argument zadaný do funkcie Nz poskytuje reťazec, ktorý sa má vrátiť, ak varFreight má hodnotu Null.

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

Príklady dotazu

Výraz	Výsledky
SELECT ProductID, NZ(Discount;"No Detail Available") AS Expr2 FROM ProductSales;	Vráti hodnotu ProductID v stĺpci Expr1, vyhodnotí hodnoty Null v poli Zľava a vráti hodnotu "Nie sú k dispozícii žiadne podrobnosti" pre všetky hodnoty Null (vráti hodnoty iné ako null tak, ako sú).
SELECT ProductID, NZ(Discount;"No Detail Available") AS ReplaceNull FROM ProductSales;	Vráti hodnotu ProductID v stĺpci Produkt, vyhodnotí hodnoty Null v poli Zľava a vráti hodnotu "Nie sú k dispozícii žiadne podrobnosti" pre všetky hodnoty Null (vráti hodnoty bez hodnoty null tak, ako sú) a zobrazí sa v stĺpci ReplaceNull.

Príklad jazyka VBA

Nasledujúci príklad vyhodnotí ovládací prvok vo formulári a na základe hodnoty ovládacieho prvku vráti jeden z dvoch reťazcov. Ak je hodnota ovládacieho prvku Null, v postupe sa použije funkcia Nz, ktorá skonvertuje hodnotu Null na reťazec s nulovou dĺžkou.

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