Enumerable.ElementAt Methode

  • Referenz

Definition

Namespace:
System.Linq
Assembly:
System.Linq.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Überlädt

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

Gibt das Element an einem angegebenen Index in einer Sequenz zurück
ElementAt<TSource>(IEnumerable<TSource>, Int32)

Gibt das Element an einem angegebenen Index in einer Sequenz zurück

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

Gibt das Element an einem angegebenen Index in einer Sequenz zurück

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Element zurückgegeben werden soll

index
Index

Der Index des abzurufenden Elements, das entweder vom Anfang oder ende der Sequenz stammt.

Gibt zurück

TSource

Das Element an der angegebenen Position in der source Sequenz.

Ausnahmen

ArgumentNullException

source ist null

ArgumentOutOfRangeException

index befindet sich außerhalb der Grenzen der source Sequenz.

Hinweise

Wenn der Typ der source Implementierungen IList<T>verwendet wird, wird diese Implementierung verwendet, um das Element am angegebenen Index abzurufen. Andernfalls ruft diese Methode das angegebene Element ab.

Diese Methode löst eine Ausnahme aus, wenn index sie außerhalb des Bereichs liegt. Verwenden Sie die ElementAtOrDefault Methode, um stattdessen einen Standardwert zurückzugeben, wenn der angegebene Index außerhalb des Bereichs liegt.

Gilt für

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

Gibt das Element an einem angegebenen Index in einer Sequenz zurück

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Element zurückgegeben werden soll

index
Int32

Der auf 0 (null) basierende Index des abzurufenden Elements.

Gibt zurück

TSource

Das Element an der angegebenen Position in der Quellsequenz.

Ausnahmen

ArgumentNullException

source ist null.

ArgumentOutOfRangeException

index ist kleiner als 0 bzw. größer oder gleich der Anzahl der Elemente in source.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, ElementAt wie ein Element an einer bestimmten Position zurückgegeben wird.

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

Hinweise

Wenn der Typ der source Implementierung verwendet IList<T>wird, wird diese Implementierung verwendet, um das Element im angegebenen Index abzurufen. Andernfalls ruft diese Methode das angegebene Element ab.

Diese Methode löst eine Ausnahme aus, wenn index sie nicht im Bereich liegt. Verwenden Sie die ElementAtOrDefault Methode, um stattdessen einen Standardwert zurückzugeben, wenn der angegebene Index außerhalb des Bereichs liegt.

Gilt für