Enumerable.ElementAt Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.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)

Quelle:

ElementAt.cs

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

C#

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

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, der entweder vom Anfang oder am 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 von source implementiert IList<T>, 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 sich außerhalb des Bereichs befindet. Verwenden Sie die ElementAtOrDefault -Methode, um stattdessen einen Standardwert zurückzugeben, wenn sich der angegebene Index außerhalb des Bereichs befindet.

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

Quelle:

ElementAt.cs

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

C#

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

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, wie ElementAt ein Element an einer bestimmten Position zurückgegeben wird.

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

Hinweise

Wenn der Typ von source implementiert IList<T>, 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 sich außerhalb des Bereichs befindet. Verwenden Sie die ElementAtOrDefault -Methode, um stattdessen einen Standardwert zurückzugeben, wenn sich der angegebene Index außerhalb des Bereichs befindet.