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

Definition

Gibt das Element an einem angegebenen Index in einer Sequenz zurückReturns 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

Type Parameters

TSource

Der Typ der Elemente von source.The type of the elements of source.

Parameters

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Element zurückgegeben werden sollAn IEnumerable<T> to return an element from.

index
Int32

Der auf 0 (null) basierende Index des abzurufenden Elements.The zero-based index of the element to retrieve.

Returns

TSource

Das Element an der angegebenen Position in der Quellsequenz.The element at the specified position in the source sequence.

Exceptions

source ist nullsource is null.

index ist kleiner als 0 bzw. größer oder gleich der Anzahl der Elemente in source.index is less than 0 or greater than or equal to the number of elements in source.

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie ElementAt verwendet wird, um ein Element an einer bestimmten Position zurückzugeben.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

Remarks

Wenn der Typ von source IList<T>implementiert, wird diese Implementierung verwendet, um das Element am angegebenen Index abzurufen.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. Andernfalls ruft diese Methode das angegebene Element ab.Otherwise, this method obtains the specified element.

Diese Methode löst eine Ausnahme aus, wenn index außerhalb des gültigen Bereichs liegt.This method throws an exception if index is out of range. Um stattdessen einen Standardwert zurückzugeben, wenn der angegebene Index außerhalb des gültigen Bereichs liegt, verwenden Sie die ElementAtOrDefault-Methode.To instead return a default value when the specified index is out of range, use the ElementAtOrDefault method.

Applies to