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.

C#

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

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.

C#

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
*/

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 elementos count , 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) produz 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.

Aplica-se a

Confira também

• Cláusula Skip (Visual Basic)