Nz függvény

Az Nz függvénnyel nullát, nulla hosszúságú karakterláncot (" " ) vagy más megadott értéket adhat vissza, ha a Variant értéke Null. A függvénnyel például egy null értéket másik értékké alakíthat át, és megakadályozhatja egy másik kifejezésen keresztüli propagálását.

Szintaxis

Nz(variant [, valueifnull ] )

Az Nz függvény argumentumai a következők:

Argumentum	Leírás:
változó	Kötelező megadni. Variant adattípusú változó.
értékhanull	Nem kötelező (kivéve, ha lekérdezésben használja). Egy Variant , amely a visszaadandó értéket adja vissza, ha a variánsargumentuma Null. Ezzel az argumentummal nullától illetve nulla hosszúságú karakterlánctól különböző értéket adhat eredményül. Megjegyzés: Ha az Nz függvényt egy lekérdezésben használja az valueifnull argumentum használata nélkül, az eredmény egy nulla hosszúságú karakterlánc lesz a null értékeket tartalmazó mezőkben.

Ha a variáns argumentum értéke Null, akkor az Nz függvény nulla vagy nulla hosszúságú karakterláncot ad vissza (lekérdezési kifejezésben használva mindig nulla hosszúságú karakterláncot ad vissza), attól függően, hogy a környezet azt jelzi, hogy az értéknek számnak vagy sztringnek kell lennie. Ha a nem kötelező valueifnull argumentumot is tartalmazza, akkor az Nz függvény az argumentum által megadott értéket adja vissza, ha a változóargumentum Null. Lekérdezési kifejezésben használva az NZ függvénynek mindig tartalmaznia kell a valueifnull argumentumot,

Ha a variant értéke nem Null, akkor az Nz függvény a variant értékét adja vissza.

Megjegyzések

Az Nz függvény olyan kifejezésekben hasznos, amelyekben lehetnek null értékek. Ha egy kifejezést arra szeretne kényszeríteni, hogy eredménye egy nem null érték legyen akkor is, ha tartalmaz null értéket, az Nz függvény használatával nullát, nulla hosszúságú karakterláncot vagy egyéni visszatérési értéket adhat vissza.

A kifejezés 2 + varX például mindig Null értéket ad vissza, ha a VariantvarXértéke Null. Azonban a 2 + Nz(varX) 2 értéket adja vissza.

Sok esetben az Nz függvény az IIf függvény alternatívájaként használható. A következő kódban például két, IIf függvényt tartalmazó kifejezésre van szükség a kívánt eredményt visszaadásához. Az első, IIf függvényt tartalmazó kifejezés egy változó értékét ellenőrzi, és nullává alakítja, ha értéke null.

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

A következő példában az Nz függvény ugyanazt a funkciót végzi el, mint az első kifejezés, és a kívánt eredményt két lépés helyett egy lépésben éri el.

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

Ha értéket ad a nem kötelező értékhanull argumentumnak, a függvény ezt az értéket adja vissza, ha a változó értéke null. E nem kötelező argumentum megadásával elkerülheti az IIf függvényt tartalmazó kifejezések használatát. Az alábbi kifejezés például az IIf függvénnyel ad vissza egy sztringet, ha az értéke varFreightNull.

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

A következő példában az Nz függvényhez megadott opcionális argumentum adja meg a visszaadandó sztringet, ha varFreightnull értékű.

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

Példák lekérdezésre

Kifejezés	Eredmény:
SELECT ProductID, NZ(Discount,"No Detail Available") AS Expr2 FROM ProductSales;	A "ProductID" értéket adja vissza az Expr1 oszlopban, kiértékeli a "Discount" mező "Null" értékeit, és a "Nincs elérhető adat" értéket adja vissza az összes Null értékhez (a nem null értékeket adja vissza, ahogy van).
SELECT ProductID, NZ(Discount,"No Detail Available") AS ReplaceNull FROM ProductSales;	A Product oszlopban a "ProductID" értéket adja vissza, kiértékeli a "Discount" mező "Null" értékeit, és a "Nincs elérhető adat" értéket adja vissza az összes Null értékhez (a nem null értékeket adja vissza, ahogy van), és a ReplaceNull oszlopban jelenik meg.

VBA-példa

Az alábbi példa egy űrlap vezérlőjét értékeli ki, és a talált érték alapján két karakterlánc közül megjeleníti az egyiket. Ha a vezérlő értéke null, az eljárás az Nz függvény használatával a null értéket nulla hosszúságú karakterlánccá alakítja.

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