Enumerable.ElementAt Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
ElementAt<TSource>(IEnumerable<TSource>, Index) |
Vrátí prvek v zadaném indexu v posloupnosti. |
ElementAt<TSource>(IEnumerable<TSource>, Int32) |
Vrátí prvek v zadaném indexu v posloupnosti. |
ElementAt<TSource>(IEnumerable<TSource>, Index)
Vrátí prvek v zadaném indexu v posloupnosti.
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
Parametry typu
- TSource
Typ prvků source
.
Parametry
- source
- IEnumerable<TSource>
Prvek IEnumerable<T> se vrátí z.
- index
- Index
Index prvku, který se má načíst, který je buď od začátku, nebo konce sekvence.
Návraty
- TSource
Prvek na zadané pozici v source
sekvenci.
Výjimky
source
je null
.
index
je mimo hranice source
sekvence.
Poznámky
Pokud typ source
implements IList<T>, tato implementace se používá k získání elementu v zadaném indexu. V opačném případě tato metoda získá zadaný prvek.
Tato metoda vyvolá výjimku, pokud index
je mimo rozsah. Chcete-li místo toho vrátit výchozí hodnotu, pokud zadaný index je mimo rozsah, použijte metodu ElementAtOrDefault .
Platí pro
ElementAt<TSource>(IEnumerable<TSource>, Int32)
Vrátí prvek v zadaném indexu v posloupnosti.
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
Parametry typu
- TSource
Typ prvků source
.
Parametry
- source
- IEnumerable<TSource>
Prvek IEnumerable<T> se vrátí z.
- index
- Int32
Index elementu založený na nule, který se má načíst.
Návraty
- TSource
Prvek na zadané pozici ve zdrojové sekvenci.
Výjimky
source
je null
.
index
je menší než 0 nebo větší než nebo rovno počtu prvků v source
.
Příklady
Následující příklad kódu ukazuje, jak použít ElementAt k vrácení elementu na konkrétní pozici.
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
Poznámky
Pokud typ source
implements IList<T>, tato implementace se používá k získání elementu v zadaném indexu. V opačném případě tato metoda získá zadaný prvek.
Tato metoda vyvolá výjimku, pokud index
je mimo rozsah. Chcete-li místo toho vrátit výchozí hodnotu, pokud zadaný index je mimo rozsah, použijte metodu ElementAtOrDefault .