Enumerable.ElementAt<TSource>(IEnumerable<TSource>, Int32) Метод

Определение

Возвращает элемент по указанному индексу в последовательности.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

Параметры типа

TSource

Тип элементов source.The type of the elements of source.

Параметры

source
IEnumerable<TSource>

Объект IEnumerable<T>, из которого требуется возвратить элемент.An IEnumerable<T> to return an element from.

index
Int32

Отсчитываемый от нуля индекс извлекаемого элемента.The zero-based index of the element to retrieve.

Возвращаемое значение

TSource

Элемент, находящийся в указанной позиции в исходной последовательности.The element at the specified position in the source sequence.

Исключения

source имеет значение null.source is null.

Значение index меньше 0 либо больше или равно числу элементов последовательности source.index is less than 0 or greater than or equal to the number of elements in source.

Примеры

В следующем примере кода показано, как использовать ElementAt для возврата элемента в заданной позиции.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 the following sample output:

 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 the following output:
'
' The name chosen at random is Ito, Shu

Комментарии

Если тип source реализует IList<T>, эта реализация используется для получения элемента по указанному индексу.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. В противном случае этот метод получает указанный элемент.Otherwise, this method obtains the specified element.

Этот метод создает исключение, если index выходит за пределы допустимого диапазона.This method throws an exception if index is out of range. Чтобы вместо этого вернуть значение по умолчанию, если указанный индекс выходит за пределы диапазона, используйте метод ElementAtOrDefault.To instead return a default value when the specified index is out of range, use the ElementAtOrDefault method.

Применяется к