Compartilhar via


Cláusula Skip (Visual Basic)

Bypasses a specified number of elements in a collection and then returns the remaining elements.

Skip count

Parts

  • count
    Required. Um valor ou uma expressão que retorna o número de elementos da sequência para ignorar.

Comentários

O Skip cláusula faz com que uma consulta ignorar os elementos no início de uma lista de resultados e retornar os elementos restantes. O número de elementos para ignorar é identificado pelo count parâmetro.

You can use the Skip clause with the Take clause to return a range of data from any segment of a query. 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.

Quando você usa o Skip cláusula em uma consulta, você pode também precisa garantir que os resultados são retornados em uma ordem que permitirá a Skip cláusula para ignorar os resultados pretendidos. For more information about ordering query results, see Cláusula Order By (Visual Basic).

Você pode usar o SkipWhile cláusula para especificar que apenas determinados elementos são ignorados, dependendo da condição fornecido.

Exemplo

The following code example uses the Skip clause together with the Take clause to return data from a query in pages. O GetCustomers função usa o Skip cláusula para ignorar os clientes na lista até o valor de índice inicial fornecida e usa o Take cláusula para retornar uma página de clientes a partir desse valor de índice .

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

Consulte também

Referência

Cláusula Select (Visual Basic)

A partir da cláusula (Visual Basic)

Cláusula Order By (Visual Basic)

Ignorar Cláusula While (Visual Basic)

Tomar cláusula (Visual Basic)

Conceitos

Introdução ao LINQ no Visual Basic

Outros recursos

Consultas(Visual Basic)