Enumerable.ElementAt<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

Retourne l’élément à un index spécifié dans une séquence.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAt(System::Collections::Generic::IEnumerable<TSource> ^ source, int index);
public static TSource ElementAt<TSource>(this System.Collections.Generic.IEnumerable<TSource> source, int index);
static member ElementAt : seq<'Source> * int -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSource

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IEnumerable<TSource>

À IEnumerable<T> partir duquel retourner un élément.

index
Int32

Index de base zéro de l’élément à récupérer.

Retours

TSource

Élément à la position spécifiée dans la séquence source.

Exceptions

ArgumentNullException

source a la valeur null.

ArgumentOutOfRangeException

index est inférieur à 0 ou supérieur ou égal au nombre d’éléments dans source.

Exemples

L’exemple de code suivant montre comment utiliser ElementAt pour retourner un élément à une position spécifique.

string[] names =
    { "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",

        "Hedlund, Magnus", "Ito, Shu" };
Random random = new Random(DateTime.Now.Millisecond);

string name = names.ElementAt(random.Next(0, names.Length));

Console.WriteLine("The name chosen at random is '{0}'.", name);

/*
 This code produces output similar to the following:

 The name chosen at random is 'Ito, Shu'.
*/

' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}

Dim random As Random = New Random(DateTime.Now.Millisecond)

' Get a string at a random index within the array.
Dim name As String = names.ElementAt(random.Next(0, names.Length))

' Display the output.
Console.WriteLine($"The name chosen at random is {name}")

' This code produces output similar to the following:
'
' The name chosen at random is Ito, Shu

Remarques

Si le type d’implémentations sourceIList<T>est utilisé pour obtenir l’élément à l’index spécifié. Sinon, cette méthode obtient l’élément spécifié.

Cette méthode lève une exception si index elle est hors limites. Pour retourner à la place une valeur par défaut lorsque l’index spécifié est hors plage, utilisez la ElementAtOrDefault méthode.

S’applique à