Enumerable.ElementAt Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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
.
Исключения
source
имеет значение null
.
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
Элемент, находящийся в указанной позиции в исходной последовательности.
Исключения
source
имеет значение null
.
Значение 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 метод.