Enumerable.ElementAt Méthode

Définition

Surcharges

ElementAt<TSource>(IEnumerable<TSource>, Index)

Retourne l'élément à une position d'index spécifiée dans une séquence.

ElementAt<TSource>(IEnumerable<TSource>, Int32)

Retourne l'élément à une position d'index spécifiée dans une séquence.

ElementAt<TSource>(IEnumerable<TSource>, Index)

Retourne l'élément à une position d'index spécifiée dans une séquence.

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

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source
IEnumerable<TSource>

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

index
Index

Index de l’élément à récupérer, qui est à partir du début ou de la fin.

Retours

TSource

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

Exceptions

source a la valeur null.

index est en dehors des limites de la source séquence.

Remarques

Si le type d' source implémente IList<T> , cette implémentation est utilisée 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 est hors limites. Pour retourner à la place une valeur par défaut lorsque l’index spécifié est hors limites, utilisez la ElementAtOrDefault méthode.

S’applique à

ElementAt<TSource>(IEnumerable<TSource>, Int32)

Retourne l'élément à une position d'index spécifiée 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

Le 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 situé à la position spécifiée dans la séquence source.

Exceptions

source a la valeur null.

index est inférieur à 0 ou supérieur ou égal au nombre d'éléments contenus 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' source implémente IList<T> , cette implémentation est utilisée 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 est hors limites. Pour retourner à la place une valeur par défaut lorsque l’index spécifié est hors limites, utilisez la ElementAtOrDefault méthode.

S’applique à