Enumerable.ElementAt Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Сборка:

System.Core.dll

Сборка:

netstandard.dll

Перегрузки

ElementAt<TSource>(IEnumerable<TSource>, Index)	Возвращает элемент по указанному индексу в последовательности.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Возвращает элемент по указанному индексу в последовательности.

ElementAt<TSource>(IEnumerable<TSource>, Index)

Возвращает элемент по указанному индексу в последовательности.

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

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

TSource

Тип элементов source.

Параметры

source

IEnumerable<TSource>

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

index

Index

Индекс извлекаемого элемента, который находится в начале или в конце последовательности.

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

TSource

Элемент в указанной позиции последовательности source .

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

index находится за пределами source последовательности.

Комментарии

Если тип source реализации IList<T>, эта реализация используется для получения элемента по указанному индексу. В противном случае этот метод получает указанный элемент.

Этот метод создает исключение, если index оно выходит за пределы диапазона. Чтобы вместо этого возвращать значение по умолчанию, если указанный индекс выходит за пределы диапазона, используйте ElementAtOrDefault метод.

ElementAt<TSource>(IEnumerable<TSource>, Int32)

Возвращает элемент по указанному индексу в последовательности.

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.

Параметры

source

IEnumerable<TSource>

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

index

Int32

Отсчитываемый от нуля индекс извлекаемого элемента.

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

TSource

Элемент, находящийся в указанной позиции в исходной последовательности.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Значение index меньше 0 либо больше или равно числу элементов последовательности source.

Примеры

В следующем примере кода показано, как использовать для ElementAt возврата элемента в определенной позиции.

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

Комментарии

Если тип source реализации IList<T>, эта реализация используется для получения элемента по указанному индексу. В противном случае этот метод получает указанный элемент.

Этот метод создает исключение, если index оно выходит за пределы диапазона. Чтобы вместо этого возвращать значение по умолчанию, если указанный индекс выходит за пределы диапазона, используйте ElementAtOrDefault метод.