Clausola Skip (Visual Basic)Skip Clause (Visual Basic)

Ignora un numero specificato di elementi in una raccolta e quindi restituisce gli elementi rimanenti.Bypasses a specified number of elements in a collection and then returns the remaining elements.

SintassiSyntax

Skip count  

PartiParts

count
Obbligatoria.Required. Valore o espressione che restituisce il numero di elementi della sequenza da ignorare.A value or an expression that evaluates to the number of elements of the sequence to skip.

NoteRemarks

La clausola Skip fa in modo che una query ignori gli elementi all'inizio di un elenco di risultati e restituisca gli elementi rimanenti.The Skip clause causes a query to bypass elements at the beginning of a results list and return the remaining elements. Il numero di elementi da ignorare è identificato dal parametro count.The number of elements to skip is identified by the count parameter.

È possibile utilizzare la clausola Skip con la clausola Take per restituire un intervallo di dati da qualsiasi segmento di una query.You can use the Skip clause with the Take clause to return a range of data from any segment of a query. A tale scopo, passare l'indice del primo elemento dell'intervallo alla clausola Skip e la dimensione dell'intervallo alla clausola 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.

Quando si utilizza la clausola Skip in una query, potrebbe essere necessario assicurarsi che i risultati vengano restituiti in un ordine che consentirà alla clausola Skip di ignorare i risultati desiderati.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. Per ulteriori informazioni sull'ordinamento dei risultati di query, vedere clausola ORDER BY.For more information about ordering query results, see Order By Clause.

È possibile usare la clausola SkipWhile per specificare che solo determinati elementi vengono ignorati, a seconda della condizione specificata.You can use the SkipWhile clause to specify that only certain elements are ignored, depending on a supplied condition.

EsempioExample

Nell'esempio di codice seguente viene utilizzata la clausola Skip insieme alla clausola Take per restituire dati da una query in pagine.The following code example uses the Skip clause together with the Take clause to return data from a query in pages. La funzione GetCustomers utilizza la clausola Skip per ignorare i clienti nell'elenco fino al valore di indice iniziale fornito e utilizza la clausola Take per restituire una pagina di clienti a partire da tale valore di indice.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

Vedere ancheSee also