Enumerable.ElementAt<TSource>(IEnumerable<TSource>, Int32) Método

Definición

Espacio de nombres:: System.Linq

Ensamblado:: System.Linq.dll

Ensamblado:: System.Core.dll

Ensamblado:: netstandard.dll

Devuelve el elemento situado en un índice especificado de una secuencia.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

Parámetros de tipo

TSource

Tipo de los elementos de source.The type of the elements of source.

Parámetros

source: IEnumerable<TSource>

IEnumerable<T> del que se va a devolver un elemento.An IEnumerable<T> to return an element from.

index: Int32

Índice de base cero del elemento que se debe recuperar.The zero-based index of the element to retrieve.

Devoluciones

TSource

El elemento situado en la posición especificada de la secuencia de origen.The element at the specified position in the source sequence.

Excepciones

ArgumentNullException

source es null.source is null.

ArgumentOutOfRangeException

index es menor que 0 o mayor o igual que el número de elementos de source.index is less than 0 or greater than or equal to the number of elements in source.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ElementAt para devolver un elemento en una posición específica.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

Comentarios

Si el tipo de source implementa IList<T> , esa implementación se utiliza para obtener el elemento en el índice especificado.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. De lo contrario, este método obtiene el elemento especificado.Otherwise, this method obtains the specified element.

Este método produce una excepción si index está fuera del intervalo.This method throws an exception if index is out of range. Para devolver un valor predeterminado cuando el índice especificado está fuera del intervalo, use el ElementAtOrDefault método.To instead return a default value when the specified index is out of range, use the ElementAtOrDefault method.

Se aplica a