Enumerable.ElementAt Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Assembly:

System.Core.dll

Assembly:

netstandard.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)

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

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

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 é do início ou do 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ção IList<T>, essa implementação será usada para obter o elemento no índice especificado. Caso contrário, esse método obterá o elemento especificado.

Esse método gera 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)

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

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

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.

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

Comentários

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

Esse método gera 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.