הפונקציה Switch

חל על
Access של Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

הערכה של רשימת ביטויים והחזרה של ערך משתנה או ביטוי המשויך לביטוי הראשון ברשימה, המוגדר כ- True.

תחביר

Switch(expr-1, value-1 [, expr-2, value-2 ] ... [, expr-n, value-n ] )

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

ארגומנט תיאור
expr נדרש. ביטוי משתנה שברצונך להעריך.
value נדרש. ערך או ביטוי שיוחזר אם הביטוי המתאים הוא True.

הערות

רשימת הארגומנטים של הפונקציה Switch מורכבת מזוגות של ביטויים וערכים. הביטויים מוערכים משמאל לימין, ומוחזר הערך המשויך לביטוי הראשון שמוערך ל - True . אם החלקים אינם משויכים כראוי, מתרחשת שגיאת זמן ריצה. לדוגמה, אם expr-1 הוא True, הפונקציה Switch מחזירה את value-1. אם expr-1 הוא False, אך expr-2 הוא True, הפונקציה Switch מחזירה את הערך -2 וכן הלאה.

הפונקציה מחזירה ערך Null אם:

  • אף אחד מהביטויים אינו True.
  • לביטוי True הראשון יש ערך תואם שהוא Null.

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

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

ביטוי תוצאות
בחר ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1","First",[ProductID]="PRO_XYZ2","Two",[ProductID]="PRO_XYZ1","Ten") AS testSwitch מ- ProductSales; החזרת ה- "ProductID", הערכת הביטויים בנוסחה "Switch" והחלפת הערכים הקיימים עם ערכים מוגדרים עבור כל ביטויי ה- "True". לדוגמה: "PRO_XYZ1" מוחלף ב"ראשון", "PRO_XYZ2" מוחלף ב"שתיים" וכן הלאה.

דוגמה ל- VBA

הערה

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

דוגמה זו משתמשת בפונקציה Switch כדי להחזיר את שם השפה התואם לשם של עיר.

Function MatchUp (CityName As String)
    Matchup = Switch(CityName = "London", "English", _
              CityName = "Rome", "Italian", _
              CityName = "Paris", "French")
End Function