عبارة يأخذ (Visual Basic)

إرجاع عدد محدد من العناصر القريبة من بداية المجموعة.

Take count

الأجزاء

  • count
    مطلوبة. القيمة أو تعبير الذي يقيم إلى عدد من العناصر للتسلسل للرجوع.

ملاحظات

جملة Take تسبب الاستعلام لتضمين عدد محدد من عناصر قريبة من بداية قائمة النتائج. عدد العناصر لتضمينها يتم تحديدها بواسطة معلمة count .

يمكنك استخدام جملة Take مع جملة Skip لإرجاع نطاق من بيانات من أي مقطع باستعلام. للقيام بذلك، قم بتمرير فهرس العنصر الأول للنطاق لجملة Skip وحجم النطاق إلى جملة Take. في هذه الحالة، الجملة Take يجب أن يتم تحديدها بعد جملة Skip .

عند استخدام جملة Take في استعلام قد تحتاج أيضاً إلى التأكد من أن يتم إرجاع النتائج بترتيب يمكن جملة Take لتضمين النتائج المقصوده. لمزيد من المعلومات حول ترتيب نتائج الاستعلام راجع بند Visual Basic) Order By).

يمكنك استخدام جملة TakeWhile لتحديد أن فقط بعض العناصر يتم ارجاعها استناداً إلى الشرط الذي تم توفيره.

مثال

مثال الـتعليمات البرمجية التالية يستخدم جملة Take مع جملة Skip لإرجاع البيانات من استعلام في صفحات. تستخدم دالة GetCustomers جملة Skip لتجاوز الزبائن في القائمة حتى قيمة فهرس البداية الذي تم توفيره ويستخدم جملة Take لإرجاع الصفحة من الزبائن بدءاً من تلك قيمة الفهرس.

Public Sub PagingSample()
  Dim pageNumber As Integer = 0
  Dim pageSize As Integer = 10

  Dim customersPage = GetCustomers(pageNumber * pageSize, pageSize)

  Do While customersPage IsNot Nothing
    Console.WriteLine(vbCrLf & "Page: " & pageNumber + 1 & vbCrLf)

    For Each cust In customersPage
      Console.WriteLine(cust.CustomerID & ", " & cust.CompanyName)
    Next

    Console.WriteLine(vbCrLf)

    pageNumber += 1
    customersPage = GetCustomers(pageNumber * pageSize, pageSize)
  Loop
End Sub

Public Function GetCustomers(ByVal startIndex As Integer,
                             ByVal pageSize As Integer) As List(Of Customer)

  Dim customers = GetCustomerList()

  Dim returnCustomers = From cust In customers
                        Skip startIndex Take pageSize

  If returnCustomers.Count = 0 Then Return Nothing

  Return returnCustomers
End Function

راجع أيضًا:

المرجع

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

فقرة From (Visual Basic)

بند Visual Basic) Order By)

بند Take While في (Visual Basic)

عبارة Visual Basic) Skip)

المبادئ

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

موارد أخرى

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