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

Definitie

Naamruimte:
System.Linq
Assembly's:
System.Core.dll, System.Linq.dll
Assembly:
System.Core.dll
Assembly:
System.Linq.dll
Assembly:
netstandard.dll

Retourneert het element in een opgegeven index in een reeks.

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

Het type van de elementen van source.

Parameters

source
IEnumerable<TSource>

Een IEnumerable<T> om een element van te retourneren.

index
Int32

De op nul gebaseerde index van het element dat moet worden opgehaald.

Retouren

TSource

Het element op de opgegeven positie in de bronreeks.

Uitzonderingen

ArgumentNullException

source is null.

ArgumentOutOfRangeException

index is kleiner dan 0 of groter dan of gelijk aan het aantal elementen in source.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe ElementAt u een element op een specifieke positie kunt retourneren.

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

Opmerkingen

Als het type source implementatie wordt IList<T>gebruikt om het element op de opgegeven index te verkrijgen. Anders verkrijgt deze methode het opgegeven element.

Met deze methode wordt een uitzondering gegenereerd als index deze buiten het bereik valt. Als u in plaats daarvan een standaardwaarde wilt retourneren wanneer de opgegeven index buiten het bereik valt, gebruikt u de ElementAtOrDefault methode.

Van toepassing op