Enumerable.ElementAt Метод

Определение

Пространство имен:
System.Linq
Сборки:
netstandard.dll, System.Linq.dll
Сборки:
System.Core.dll, System.Linq.dll
Сборка:
System.Linq.dll
Сборка:
System.Core.dll
Сборка:
netstandard.dll

Перегрузки

Имя Описание
ElementAt<TSource>(IEnumerable<TSource>, Index)

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

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

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

Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs

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

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)

Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs
Исходный код:
ElementAt.cs

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

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 метод.

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