הפונקציה Nz

באפשרותך להשתמש בפונקציה Nz כדי להחזיר אפס, מחרוזת באורך אפס (" "), או ערך מוגדר אחר כאשר משתנה הוא Null. לדוגמה, ניתן להשתמש בפונקציה זו כדי להמיר ערך Null לערך אחר ולמנוע את הפצתו דרך ביטוי.

תחביר

Nz ( variant [, valueifnull ] )‎

תחביר הפונקציה Nz כולל את הארגומנטים הבאים:

ארגומנט	תיאור
*variant*	נדרש. משתנה של סוג נתונים של סוג נתונים.
*valueifnull*	אופציונלי (אלא אם נעשה בו שימוש בשאילתה). Variant המספק ערך להחזרה אם הארגומנט *variant* הוא Null. ארגומנט זה מאפשר לך להחזיר ערך השונה מאפס או ממחרוזת באורך אפס. הערה: בעת שימוש בפונקציה Nz בביטוי בשאילתה מבלי להשתמש בארגומנט *valueifnull*, התוצאות יהיו מחרוזת באורך אפס בשדות שמכילים את הערכים הריקים.

אם הערך של הארגומנט variant הוא Null, הפונקציה Nz מחזירה את המספר אפס או מחרוזת באורך אפס (תמיד מחזירה מחרוזת באורך אפס כאשר נעשה בה שימוש בביטוי שאילתה), בהתאם לקביעה אם ההקשר המציין את הערך אמור להיות מספר או מחרוזת. אם הארגומנט האופציונלי valueifnull כלול, הפונקציה Nz תחזיר את הערך שצוין על-ידי אותו ארגומנט אם הארגומנט variant הוא Null. בעת שימוש בביטוי שאילתה, הפונקציה NZ אמורה תמיד לכלול את הארגומנט valueifnull,

אם הערך של variant אינו Null, הפונקציה Nz מחזירה את הערך של variant.

הערות

הפונקציה Nz שימושית עבור ביטויים שעשויים לכלול ערכי Null. כדי לכפות הערכה של ביטוי לערך שאינו Null גם כאשר הוא מכיל ערך Null, השתמש בפונקציה Nz כדי להחזיר אפס, מחרוזת באורך אפס או ערך החזרה מותאם אישית.

לדוגמה, הביטוי 2 + varX תמיד יחזיר ערך Null כאשר המשתנה varX הוא Null. עם זאת, 2 + Nz(varX) מחזיר 2.

לרוב, ניתן להשתמש בפונקציה Nz כחלופה לפונקציה IIf. לדוגמה, בקוד הבא, שני ביטויים כולל הפונקציה IIf נחוצים כדי להחזיר את התוצאה הרצויה. הביטוי הראשון, כולל הפונקציה IIf משמש כדי לבדוק ערך של משתנה ולהמיר אותו לאפס אם הוא Null.

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

בדוגמה הבאה, הפונקציה Nz מספקת את אותה פונקציונליות כמו זו של הביטוי הראשון, והתוצאה הרצויה מושגת בשלב אחד במקום בשני שלבים.

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

אם תספק ערך עבור הארגומנט האופציונלי valueifnull, ערך זה יוחזר כאשר variant הוא Null. על-ידי הכללת הארגומנט האופציונלי, ייתכן שתוכל למנוע את השימוש בביטוי המכיל את הפונקציה IIf. לדוגמה, הביטוי הבא משתמש בפונקציה IIf כדי להחזיר מחרוזת אם הערך של varFreight הוא Null.

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

בדוגמה הבאה, הארגומנט האופציונלי שסופק Nz פונקציה מספק את המחרוזת שיוחזר אם varFreight הוא Null.

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

דוגמאות שאילתה

Expression	תוצאות
SELECT ProductID, NZ(Discount,"No Detail Available") AS Expr2 FROM ProductSales;	מחזירה "ProductID" בעמודה Expr1, מעריכה את ערכי 'Null' בשדה "Discount" ומחזירה "No Details Available" עבור כל ערכי Null (מחזירה את הערכים שאינם Null כפי שהוא).
SELECT ProductID, NZ(Discount,"No Detail Available") AS ReplaceNull FROM ProductSales;	מחזירה "ProductID" בעמודה Product, מעריכה את ערכי 'Null' בשדה "Discount" ומחזירה "No Details Available" עבור כל ערכי Null (מחזירה את הערכים שאינם Null כפי שהוא) ומציגה בעמודה ReplaceNull.

דוגמה ל- VBA

הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications‏ (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.

הדוגמה הבאה מעריכה פקד בטופס ומחזירה מחרוזת אחת מתוך שתי מחרוזות בהתבסס על ערך הפקד. אם הערך של הפקד הוא Null, ההליך משתמש בפונקציה Nz כדי להמיר ערך Null למחרוזת באורך אפס.

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

הערות

דוגמאות שאילתה

דוגמה ל- VBA

זקוק לעזרה נוספת?

מעוניין באפשרויות נוספות?

האם מידע זה היה שימושי?

תודה על המשוב!