تقييم قائمة من التعبيرات وإرجاع قيمة متغير أو تعبير مقترن بالتعبير الأول في القائمة وهي True.
بناء الجملة
Switch( expr-1, value-1 [, expr-2, value-2 ] ... [، expr-n، value-n ] )
يحتوي بناء جملة الدالة Switch على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
expr |
مطلوبة. تعبير متغير تريد تقييمه. |
|
value |
مطلوبة. القيمة أو التعبير المراد إرجاعه إذا كان التعبير المقابل هو True. |
ملاحظات
تتكون قائمة وسيطة الدالة Switch من أزواج من التعبيرات والقيم. يتم تقييم التعبيرات من اليسار إلى اليمين، ويتم إرجاع القيمة المقترنة بالتعبير الأول المراد تقييمه إلى True . إذا لم يتم إقران الأجزاء بشكل صحيح، يحدث خطأ أثناء التشغيل. على سبيل المثال، إذا كان expr-1هو True، ترجع Switchالقيمة-1. إذا كان expr-1خطأ، ولكن expr-2هو True، ترجع Switchالقيمة-2، وهكذا.
ترجع Switch قيمة Null إذا:
-
لا يوجد أي تعبير من التعبيرات True.
-
يحتوي التعبير True الأول على قيمة مطابقة هي Null.
يقوم Switch بتقييم جميع التعبيرات، على الرغم من أنه يرجع تعبيرا واحدا منها فقط. لهذا السبب، يجب أن تشاهد الآثار الجانبية غير المرغوب فيها. على سبيل المثال، إذا كان تقييم أي تعبير يؤدي إلى قسمة على صفر خطأ، يحدث خطأ.
مثال على الاستعلام
|
تعبير |
النتائج |
|
SELECT ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1","First",[ProductID]="PRO_XYZ2","Two",[ProductID]="PRO_XYZ1","Ten") AS testSwitch FROM 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
