Enumerable.ElementAt Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

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 de la séquence.

Retours

TSource

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

Exceptions

ArgumentNullException

source a la valeur null.

ArgumentOutOfRangeException

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

Remarques

Si le type d’implémentation source est IList<T>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 plage. Pour renvoyer une valeur par défaut lorsque l’index spécifié est hors de plage, utilisez la ElementAtOrDefault méthode.

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

ArgumentNullException

source a la valeur null.

ArgumentOutOfRangeException

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 retourner ElementAt 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émentation source est IList<T>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 plage. Pour renvoyer une valeur par défaut lorsque l’index spécifié est hors de plage, utilisez la ElementAtOrDefault méthode.