Enumerable.Skip<TSource>(IEnumerable<TSource>, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um IEnumerable<T> que contém os elementos que ocorrem após o índice especificado na sequência de entrada.
Exceções
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 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.
