عبارة Visual Basic) where)

تعيّن شرط التصفية في الاستعلام.

Where condition

الأجزاء

• condition
  مطلوبة. تعبير الذي يحدد ما إذا كانت القيم للعنصر الحالي في المجموعة مُضمنة في مجموعة الإخراج. يجب أن يتم تقييم التعبير إلى القيمة Boolean أو المكافئ القيمة Boolean. إذا تم تقييم الشرط إلى True، يتم تضمين العنصر في نتيجة الاستعلام، وإلا, يتم استبعاد العنصر من نتيجة الاستعلام.

ملاحظات

العبارة Where تمكنك من تصفية استعلام البيانات عن طريق تحديد العناصر التي تحقق خصائص معينة. عناصر يؤدي قيمها جملة Where لتقييم إلى True يتم تضمينه في نتائج الاستعلام، العناصر الأخرى يتم استثناءها. تعبير يُستخدم في جملة Where يجب أن تقيّم Boolean أو ما يساويها من Boolean، مثل عدد صحيح يتم تقييمها إلى False عندما تكون قيمتها صفر. يمكنك دمج عدة تعبيرات في عبارة Where عن طريق استخدام عوامل التشغيل المنطقية مثل And, Or, AndAlso, OrElse, Is، و IsNot.

بشكل افتراضي، تعبيرات الاستعلام لا يتم تقييمها حتى يتم الوصول إليها — على سبيل المثال، عندما تكون متكررة خلال ربط بيانات تكرار حلقي For . ونتيجة لذلك، عبارة Where لا يتم تقييمها حتى يتم الوصول إلى الاستعلام. إذا كان لديك خارجي إلى قيم استعلام التي تُستخدم في جملة Where التأكد من استخدام القيمة المناسبة في جملة Where في الوقت استعلام يتم تنفيذه. لمزيد من المعلومات حول استعلام التنفيذ, راجع كتابة كلمة الاستعلام LINQ الأول (Visual Basic).

يمكنك استدعاء دوال داخل جملة Where بتنفيذ العملية الحسابية أو عملية على القيمة من العنصر الحالي في المجموعة. استدعاء دالة Where يؤدي ذلك أنّ جملة استعلام لتنفيذه مباشرةً عندما يتم تعريفه بدلاً من عندما يتم الوصول إليه. لمزيد من المعلومات حول استعلام التنفيذ, راجع كتابة كلمة الاستعلام LINQ الأول (Visual Basic).

مثال

يستخدم تعبير الاستعلام التالي جملة From لتعريف متغير النطاق cust لكل كائن Customer في مجموعة customers . يستخدم جملة Where متغير النطاق لتقييد الإخراج لعملاء من منطقة محددة. يعرض التكرار الحلقي For Each اسم الشركة لكل عميل في نتيجة الاستعلام.

Sub DisplayCustomersForRegion(ByVal customers As List(Of Customer),
                              ByVal region As String)

  Dim customersForRegion = From cust In customers
                           Where cust.Region = region

  For Each cust In customersForRegion
    Console.WriteLine(cust.CompanyName)
  Next
End Sub

راجع أيضًا:

المرجع

فقرة From (Visual Basic)

تحديد العبارة (Visual Basic)

عبارة Visual Basic) For Each...Next)

المبادئ

مقدمة حول LINQ في Visual Basic

موارد أخرى

استعلامات (Visual Basic)