Enumerable.Skip<TSource>(IEnumerable<TSource>, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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<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 vacío IEnumerable<T> . Si count
es menor o igual que cero, se producen todos los elementos de source
.
Los Take métodos y Skip son complementos 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.