Duration (Pacific Standard Time):
To (Pacific Standard Time):
  • None
User Action:
  • None

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


Returns the element at a specified index in a sequence.

Namespace:   System.Linq
Assembly:  System.Core (in System.Core.dll)

Public Shared Function ElementAt(Of TSource) (
	source As IEnumerable(Of TSource),
	index As Integer
) As TSource


Type: System.Collections.Generic.IEnumerable<TSource>

An IEnumerable<T> to return an element from.

Type: System.Int32

The zero-based index of the element to retrieve.

Return Value

Type: TSource

The element at the specified position in the source sequence.

Type Parameters


The type of the elements of source.

Exception Condition

source is null.


index is less than 0 or greater than or equal to the number of elements in source.

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.

This method throws an exception if index is out of range. To instead return a default value when the specified index is out of range, use the ElementAtOrDefault<TSource> method.

The following code example demonstrates how to use ElementAt<TSource> to return an element at a specific position.

' 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.
MsgBox("The name chosen at random is " & name)

' This code produces the following output:
' The name chosen at random is Ito, Shu

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top