Enumerable.ElementAt Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Sobrecargas

ElementAt<TSource>(IEnumerable<TSource>, Index)	Devuelve el elemento situado en un índice especificado de una secuencia.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Devuelve el elemento situado en un índice especificado de una secuencia.

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

Source:

ElementAt.cs

Devuelve el elemento situado en un índice especificado de una secuencia.

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

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> del que se va a devolver un elemento.

index

Index

Índice del elemento que se va a recuperar, que es desde el principio o el final de la secuencia.

Devoluciones

TSource

Elemento situado en la posición especificada de la source secuencia.

Excepciones

ArgumentNullException

source es null.

ArgumentOutOfRangeException

index está fuera de los límites de la source secuencia.

Comentarios

Si el tipo de source implementa IList<T>, esa implementación se usa para obtener el elemento en el índice especificado. De lo contrario, este método obtiene el elemento especificado.

Este método produce una excepción si index está fuera del intervalo. Para devolver en su lugar un valor predeterminado cuando el índice especificado está fuera del intervalo, use el ElementAtOrDefault método .

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

Source:

ElementAt.cs

Devuelve el elemento situado en un índice especificado de una secuencia.

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.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> del que se va a devolver un elemento.

index

Int32

Índice de base cero del elemento que se debe recuperar.

Devoluciones

TSource

El elemento situado en la posición especificada de la secuencia de origen.

Excepciones

ArgumentNullException

source es null.

ArgumentOutOfRangeException

index es menor que 0 o mayor o igual que el número de elementos de 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.

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

Comentarios

Si el tipo de source implementa IList<T>, esa implementación se usa para obtener el elemento en el índice especificado. De lo contrario, este método obtiene el elemento especificado.

Este método produce una excepción si index está fuera del intervalo. Para devolver en su lugar un valor predeterminado cuando el índice especificado está fuera del intervalo, use el ElementAtOrDefault método .