Enumerable.ElementAt Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
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, à partir du début ou de la fin de la séquence.
Retours
É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 de 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 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)
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
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
É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 de 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 une valeur par défaut lorsque l’index spécifié est hors limites, utilisez la ElementAtOrDefault méthode .