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

Définition

Espace de noms:
System.Linq
Assemblys:
System.Core.dll, System.Linq.dll
Assembly:
System.Core.dll
Assembly:
System.Linq.dll
Assembly:
netstandard.dll

Contourne un nombre spécifié d’éléments dans une séquence, puis retourne les éléments restants.

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)

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IEnumerable<TSource>

À IEnumerable<T> partir duquel renvoyer des éléments.

count
Int32

Nombre d’éléments à ignorer avant de retourner les éléments restants.

Retours

IEnumerable<TSource>

Qui IEnumerable<T> contient les éléments qui se produisent après l’index spécifié dans la séquence d’entrée.

Exceptions

ArgumentNullException

source a la valeur null.

Exemples

L’exemple de code suivant montre comment ignorer Skip un nombre spécifié d’éléments dans un tableau et retourner les éléments restants.

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

Remarques

Cette méthode est implémentée à l’aide de l’exécution différée. La valeur de retour immédiate est un objet qui stocke toutes les informations requises pour effectuer l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré en appelant directement sa méthode GetEnumerator ou en utilisant foreach en C# ou For Each dans Visual Basic.

Si source elle contient moins d’éléments count , une valeur vide IEnumerable<T> est retournée. S’il count est inférieur ou égal à zéro, tous les éléments d’entre source elles sont générés.

Les Take méthodes et Skip les compléments fonctionnels. Étant donné une séquence coll de collection et un entier n, concaténation des résultats et coll.Take(n)coll.Skip(n) génère la même séquence que coll.

Dans Visual Basic syntaxe d’expression de requête, une clause Skip se traduit par un appel de Skip.

S’applique à

Voir aussi