Enumerable.Skip<TSource>(IEnumerable<TSource>, Int32) Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Origem:

Skip.cs

Ignora um número especificado de elementos em uma sequência e retorna os elementos restantes.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ Skip(System::Collections::Generic::IEnumerable<TSource> ^ source, int count);

public static System.Collections.Generic.IEnumerable<TSource> Skip<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int count);

static member Skip : seq<'Source> * int -> seq<'Source>

<Extension()>
Public Function Skip(Of TSource) (source As IEnumerable(Of TSource), count As Integer) As IEnumerable(Of TSource)

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> do qual os elementos serão retornados.

count

Int32

O número de elementos a serem ignorados antes de retornar os elementos restantes.

Retornos

IEnumerable<TSource>

Um IEnumerable<T> que contém os elementos que ocorrem após o índice especificado na sequência de entrada.

Exceções

ArgumentNullException

source é null.

Exemplos

O exemplo de código a seguir demonstra como usar Skip para ignorar um número especificado de elementos em uma matriz e retornar os elementos restantes.

int[] grades = { 59, 82, 70, 56, 92, 98, 85 };

Console.WriteLine("All grades except the first three:");
foreach (int grade in grades.Skip(3))
{
    Console.WriteLine(grade);
}

/*
 This code produces the following output:

All grades except the first three:
 56
 92
 98
 85
*/

' Create an array of integers that represent grades.
Dim grades() As Integer = {59, 82, 70, 56, 92, 98, 85}

' Sort the numbers in descending order and
' get all but the first (largest) three numbers.
Dim skippedGrades As IEnumerable(Of Integer) =
grades _
.Skip(3)

' Display the results.
Dim output As New System.Text.StringBuilder("All grades except the first three are:" & vbCrLf)
For Each grade As Integer In skippedGrades
    output.AppendLine(grade)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' All grades except the first three are:
' 56
' 92
' 98
' 85

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

Se source contiver menos de count elementos, um vazio IEnumerable<T> será retornado. Se count for menor ou igual a zero, todos os elementos de source serão gerados.

Os Take métodos e Skip são complementos funcionais. Dada uma sequência coll de coleção e um inteiro n, concatenar os resultados de coll.Take(n) e coll.Skip(n) produzir a mesma sequência que coll.

Na sintaxe da expressão de consulta do Visual Basic, uma Skip cláusula é convertida em uma invocação de Skip.

Confira também

• Cláusula Skip (Visual Basic)