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

Definição

Retorna o elemento de um índice especificado em uma sequência.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

O tipo dos elementos de source.The type of the elements of source.

Parâmetros

source
IEnumerable<TSource>

Um IEnumerable<T> do qual um elemento será retornado.An IEnumerable<T> to return an element from.

index
Int32 Int32 Int32 Int32

O índice baseado em zero do elemento a ser recuperado.The zero-based index of the element to retrieve.

Retornos

TSource TSource TSource TSource

O elemento na posição especificada na sequência de origem.The element at the specified position in the source sequence.

Exceções

index é menor que 0 ou maior ou igual ao número de elementos em source.index is less than 0 or greater than or equal to the number of elements in source.

Exemplos

O exemplo de código a seguir demonstra como usar ElementAt para retornar um elemento em uma posição 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.
MsgBox("The name chosen at random is " & name)

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

Comentários

Se o tipo de source implementa IList<T>, que a implementação é usada para obter o elemento no índice especificado.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. Caso contrário, esse método obtém o elemento especificado.Otherwise, this method obtains the specified element.

Esse método gera uma exceção se index está fora do intervalo.This method throws an exception if index is out of range. Para retornar em vez disso, um valor padrão quando o índice especificado está fora do intervalo, use o ElementAtOrDefault método.To instead return a default value when the specified index is out of range, use the ElementAtOrDefault method.

Aplica-se a