הפונקציה 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")

דוגמה

הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול 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
הרחב את הכישורים שלך
סייר בהדרכה
קבל תכונות חדשות לפני כולם
הצטרף למשתתפי Office Insider

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

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

תודה על המשוב! נראה שכדאי לקשר אותך לאחד מנציגי התמיכה של Office.

×