Предложение Skip (Visual Basic)Skip Clause (Visual Basic)

Пропускает заданное число элементов в коллекции и возвращает остальные элементы.Bypasses a specified number of elements in a collection and then returns the remaining elements.

СинтаксисSyntax

Skip count  

ЧастиParts

count
Обязательный.Required. Значение или выражение, результатом является число элементов последовательности, чтобы пропустить.A value or an expression that evaluates to the number of elements of the sequence to skip.

ПримечанияRemarks

Skip Предложение вызывает запрос для пропуска элементов в начале списка результатов и возвращает остальные элементы.The Skip clause causes a query to bypass elements at the beginning of a results list and return the remaining elements. Количество пропускаемых элементов определяется count параметра.The number of elements to skip is identified by the count parameter.

Можно использовать Skip предложение with Take предложение можно получить диапазон данных из любого фрагмента запроса.You can use the Skip clause with the Take clause to return a range of data from any segment of a query. Для этого передайте индекс первого элемента диапазона Skip предложение и размер диапазона Take предложение.To do this, pass the index of the first element of the range to the Skip clause and the size of the range to the Take clause.

При использовании Skip предложением запроса, также необходимо убедиться, что результаты возвращаются в порядке, который позволит Skip предложение для обхода желаемых результатов.When you use the Skip clause in a query, you may also need to ensure that the results are returned in an order that will enable the Skip clause to bypass the intended results. Дополнительные сведения о сортировке результатов запроса, см. в разделе предложение Order By.For more information about ordering query results, see Order By Clause.

Можно использовать SkipWhile предложение, чтобы указать, что только определенные элементы игнорируются, в зависимости от предоставленного условия.You can use the SkipWhile clause to specify that only certain elements are ignored, depending on a supplied condition.

ПримерExample

В следующем примере кода используется Skip предложение вместе с Take предложение, чтобы вернуть данные из запроса на страницах.The following code example uses the Skip clause together with the Take clause to return data from a query in pages. GetCustomers Функция использует Skip предложение для пропуска всех клиентов, в списке, пока не указанного начального индекса значение, а также используется Take предложение для возврата страницы клиентов, начиная с этого значения индекса.The GetCustomers function uses the Skip clause to bypass the customers in the list until the supplied starting index value, and uses the Take clause to return a page of customers starting from that index value.

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

См. такжеSee also