Enumerable.ElementAt<TSource>(IEnumerable<TSource>, Int32) Metoda

Definicja

Przestrzeń nazw:
System.Linq
Zestaw:
System.Linq.dll
Zestaw:
netstandard.dll
Zestaw:
System.Core.dll

Zwraca element o określonym indeksie w sekwencji.Returns the element at a specified index in a sequence.

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 elementów source .The type of the elements of source.

Parametry

source
IEnumerable<TSource>

IEnumerable<T>Do zwrócenia elementu z.An IEnumerable<T> to return an element from.

index
Int32

Indeks (liczony od zera) elementu do pobrania.The zero-based index of the element to retrieve.

Zwraca

TSource

Element w określonej pozycji w sekwencji źródłowej.The element at the specified position in the source sequence.

Wyjątki

ArgumentNullException

source to null.source is null.

ArgumentOutOfRangeException

index jest mniejsza od 0 lub większa lub równa liczbie elementów w source .index is less than 0 or greater than or equal to the number of elements in source.

Przykłady

Poniższy przykład kodu demonstruje, jak użyć ElementAt do zwrócenia elementu w określonej pozycji.The following code example demonstrates how to use ElementAt to return an element at a specific position.

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

Uwagi

Jeśli typ source IList<T> implementacji, ta implementacja jest używana w celu uzyskania elementu pod określonym indeksem.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. W przeciwnym razie ta metoda uzyskuje określony element.Otherwise, this method obtains the specified element.

Ta metoda zgłasza wyjątek, jeśli index jest poza zakresem.This method throws an exception if index is out of range. Aby zamiast tego zwrócić wartość domyślną, gdy określony indeks jest poza zakresem, użyj ElementAtOrDefault metody.To instead return a default value when the specified index is out of range, use the ElementAtOrDefault method.

Dotyczy