Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Enumerable.Take<TSource>, méthode (IEnumerable<TSource>, Int32)

 

Retourne un nombre spécifié d’éléments contigus à partir du début d’une séquence.

Espace de noms:   System.Linq
Assembly:  System.Core (dans System.Core.dll)

public static IEnumerable<TSource> Take<TSource>(
	this IEnumerable<TSource> source,
	int count
)

Paramètres

source
Type: System.Collections.Generic.IEnumerable<TSource>

Séquence à partir de laquelle retourner les éléments.

count
Type: System.Int32

Nombre d'éléments à retourner.

Valeur de retour

Type: System.Collections.Generic.IEnumerable<TSource>

Un IEnumerable<T> qui contient le nombre spécifié d’éléments à partir du début de la séquence d’entrée.

Paramètres de type

TSource

Le type des éléments de source.

Exception Condition
ArgumentNullException

source a la valeur null.

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

Take<TSource> énumère les source et retourne les éléments jusqu'à ce que count éléments ont été rapportés ou sourcecontient plus d’éléments. Si count dépasse le nombre d’éléments dans source, tous les éléments de sourcesont retournées.

Si count est inférieur ou égal à zéro, source n’est pas énumérées et une erreur IEnumerable<T> est retournée.

Le Take<TSource> et Skip<TSource> méthodes sont des compléments fonctionnels. Reçoit une séquence coll et un entier n, les résultats de concaténation de coll.Take(n) et coll.Skip(n) génère la même séquence que coll.

Dans Visual Basic syntaxe d’expression de requête une Take clause se traduit par un appel à Take<TSource>.

L’exemple de code suivant montre comment utiliser Take<TSource> pour retourner des éléments à partir du début d’une séquence.

int[] grades = { 59, 82, 70, 56, 92, 98, 85 };

IEnumerable<int> topThreeGrades =
    grades.OrderByDescending(grade => grade).Take(3);

Console.WriteLine("The top three grades are:");
foreach (int grade in topThreeGrades)
{
    Console.WriteLine(grade);
}
/*
 This code produces the following output:

 The top three grades are:
 98
 92
 85
*/

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 3.5
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: