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

Definición

Omite un número especificado de elementos en una secuencia y luego devuelve los 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

Tipo de los elementos de source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> del que se van a devolver los elementos.

count
Int32

Número de elementos que se van a omitir antes de devolver los elementos restantes.

Devoluciones

IEnumerable<TSource>

IEnumerable<T> que contiene los elementos que hay después del índice especificado en la secuencia de entrada.

Excepciones

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar Skip para omitir un número especificado de elementos de una matriz y devolver los 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

Comentarios

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator método o mediante foreach en C# o For Each en Visual Basic.

Si source contiene menos count elementos, se devuelve un valor vacío IEnumerable<T> . Si count es menor o igual que cero, se devuelven todos los elementos de source .

Los Take métodos y Skip son complementarios funcionales. Dada una secuencia coll de colección y un entero n, concatenando los resultados de coll.Take(n) y coll.Skip(n) produce la misma secuencia que coll.

En la sintaxis de la expresión de consulta de Visual Basic, una Skip cláusula se traduce en una invocación de Skip.

Se aplica a

Consulte también