Queryable.ElementAt Methode

  • Referenz

Definition

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

Überlädt

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

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

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

ElementAt<TSource>(IQueryable<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::Linq::IQueryable<TSource> ^ source, Index index);
public static TSource ElementAt<TSource> (this System.Linq.IQueryable<TSource> source, Index index);
static member ElementAt : System.Linq.IQueryable<'Source> * Index -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IQueryable(Of TSource), index As Index) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IQueryable<TSource>

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

index
Index

Der Index des zu abrufenden Elements, das entweder vom Anfang oder ende aus ist.

Gibt zurück

TSource

Das Element an der angegebenen Position in der source Sequenz.

Ausnahmen

ArgumentNullException

source ist null.

ArgumentOutOfRangeException

index ist außerhalb der Grenzen der source Sequenz.

Gilt für

ElementAt<TSource>(IQueryable<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::Linq::IQueryable<TSource> ^ source, int index);
public static TSource ElementAt<TSource> (this System.Linq.IQueryable<TSource> source, int index);
static member ElementAt : System.Linq.IQueryable<'Source> * int -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IQueryable(Of TSource), index As Integer) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IQueryable<TSource>

Ein IQueryable<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 source.

Ausnahmen

ArgumentNullException

source ist null.

ArgumentOutOfRangeException

index ist kleiner als Null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, ElementAt<TSource>(IQueryable<TSource>, Int32) wie ein Element an einer bestimmten Position in einer Sequenz 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.AsQueryable().ElementAt(random.Next(0, names.Length));

Console.WriteLine("The name chosen at random is '{0}'.", name);

/*
    This code produces the following sample output.
    Yours may be different due to the use of Random.

    The name chosen at random is 'Ito, Shu'.
*/

Dim names() As String = {"Hartono, Tommy", "Adams, Terry", _
                   "Andersen, Henriette Thaulow", _
                   "Hedlund, Magnus", "Ito, Shu"}

Dim rand As New Random(DateTime.Now.Millisecond)

Dim name As String = _
    names.AsQueryable().ElementAt(rand.Next(0, names.Length))

MsgBox(String.Format("The name chosen at random is '{0}'.", name))

' This code produces the following sample output.
' Yours may be different due to the use of Random.
'
' The name chosen at random is 'Ito, Shu'.

Hinweise

Die ElementAt<TSource>(IQueryable<TSource>, Int32) Methode generiert eine MethodCallExpression , die das Aufrufen ElementAt<TSource>(IQueryable<TSource>, Int32) selbst als konstruierte generische Methode darstellt. Anschließend wird die MethodCallExpression Methode IQueryProvider des dargestellten Objekts durch die Execute<TResult>(Expression) Provider Eigenschaft des source Parameters übergeben.

Das Abfrageverhalten, das aufgrund der Ausführung einer Ausdrucksstruktur auftritt, die aufruft, hängt von der Implementierung des Typs ElementAt<TSource>(IQueryable<TSource>, Int32) des source Parameters ab. Das erwartete Verhalten besteht darin, dass das Element an der Position index in source.

Gilt für