Enumerable.ElementAt Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

ElementAt<TSource>(IEnumerable<TSource>, Index)	Retorna o elemento de um índice especificado em uma sequência.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Retorna o elemento de um índice especificado em uma sequência.

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

Origem:

ElementAt.cs

Retorna o elemento de um índice especificado em uma sequência.

C#

public static TSource ElementAt<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Index index);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> do qual um elemento será retornado.

index

Index

O índice do elemento a ser recuperado, que é desde o início ou o final da sequência.

Retornos

TSource

O elemento na posição especificada na source sequência.

Exceções

ArgumentNullException

source é null.

ArgumentOutOfRangeException

index está fora dos limites da source sequência.

Comentários

Se o tipo de source implementa IList<T>, essa implementação será usada para obter o elemento no índice especificado. Caso contrário, esse método obtém o elemento especificado.

Esse método gerará uma exceção se index estiver fora do intervalo. Para retornar um valor padrão quando o índice especificado estiver fora do intervalo, use o ElementAtOrDefault método .

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

Origem:

ElementAt.cs

Retorna o elemento de um índice especificado em uma sequência.

C#

public static TSource ElementAt<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> do qual um elemento será retornado.

index

Int32

O índice baseado em zero do elemento a ser recuperado.

Retornos

TSource

O elemento na posição especificada na sequência de origem.

Exceções

ArgumentNullException

source é null.

ArgumentOutOfRangeException

index é menor que 0 ou maior ou igual ao número de elementos em source.

Exemplos

O exemplo de código a seguir demonstra como usar ElementAt para retornar um elemento em uma posição específica.

C#

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'.
*/

Comentários

Se o tipo de source implementa IList<T>, essa implementação será usada para obter o elemento no índice especificado. Caso contrário, esse método obtém o elemento especificado.

Esse método gerará uma exceção se index estiver fora do intervalo. Para retornar um valor padrão quando o índice especificado estiver fora do intervalo, use o ElementAtOrDefault método .