Freigeben über

Queryable.ElementAtOrDefault Methode

Definition

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

Überlädt

Name Beschreibung
ElementAtOrDefault<TSource>(IQueryable<TSource>, Index)

Gibt das Element an einem angegebenen Index in einer Sequenz oder einem Standardwert zurück, wenn der Index außerhalb des Bereichs liegt.
ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)

Gibt das Element an einem angegebenen Index in einer Sequenz oder einem Standardwert zurück, wenn der Index außerhalb des Bereichs liegt.

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

Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs

Gibt das Element an einem angegebenen Index in einer Sequenz oder einem Standardwert zurück, wenn der Index außerhalb des Bereichs liegt.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Linq::IQueryable<TSource> ^ source, Index index);
public static TSource? ElementAtOrDefault<TSource>(this System.Linq.IQueryable<TSource> source, Index index);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")]
public static TSource? ElementAtOrDefault<TSource>(this System.Linq.IQueryable<TSource> source, Index index);
static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * Index -> 'Source
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")>]
static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * Index -> 'Source
<Extension()>
Public Function ElementAtOrDefault(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> , von dem ein Element zurückgegeben werden soll.

index
Index

Der Index des abzurufenden Elements, das entweder vom Anfang oder vom Ende stammt.

Gibt zurück

TSource

default wenn index sich außerhalb der Grenzen der source Sequenz befindet, andernfalls das Element an der angegebenen Position in der source Sequenz.

Attribute
RequiresDynamicCodeAttribute

Ausnahmen

ArgumentNullException

source ist null.

Gilt für:

ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)

Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs
Quelle:
Queryable.cs

Gibt das Element an einem angegebenen Index in einer Sequenz oder einem Standardwert zurück, wenn der Index außerhalb des Bereichs liegt.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Linq::IQueryable<TSource> ^ source, int index);
public static TSource ElementAtOrDefault<TSource>(this System.Linq.IQueryable<TSource> source, int index);
public static TSource? ElementAtOrDefault<TSource>(this System.Linq.IQueryable<TSource> source, int index);
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")]
public static TSource? ElementAtOrDefault<TSource>(this System.Linq.IQueryable<TSource> source, int index);
static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * int -> 'Source
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Enumerating collections as IQueryable can require creating new generic types or methods, which requires creating code at runtime. This may not work when AOT compiling.")>]
static member ElementAtOrDefault : System.Linq.IQueryable<'Source> * int -> 'Source
<Extension()>
Public Function ElementAtOrDefault(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> , von dem ein Element zurückgegeben werden soll.

index
Int32

Der nullbasierte Index des abzurufenden Elements.

Gibt zurück

TSource

default(TSource) wenn index sich außerhalb der Grenzen von source; andernfalls das Element an der angegebenen Position in source.

Attribute
RequiresDynamicCodeAttribute

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)veranschaulicht. In diesem Beispiel wird ein Wert verwendet, der index sich außerhalb der Grenzen der Quellsequenz befindet.

string[] names = { "Hartono, Tommy", "Adams, Terry",
                   "Andersen, Henriette Thaulow",
                   "Hedlund, Magnus", "Ito, Shu" };

int index = 20;

string name = names.AsQueryable().ElementAtOrDefault(index);

Console.WriteLine(
    "The name chosen at index {0} is '{1}'.",
    index,
    String.IsNullOrEmpty(name) ? "[NONE AT THIS INDEX]" : name);

/*
    This code produces the following output:

    The name chosen at index 20 is '[NONE AT THIS INDEX]'.
*/

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

Dim index As Integer = 20

Dim name As String = names.AsQueryable().ElementAtOrDefault(index)

MsgBox(String.Format("The name at index {0} is '{1}'.", _
    index, IIf(String.IsNullOrEmpty(name), "[NONE AT THIS INDEX]", name)))

' This code produces the following output:
'
' The name at index 20 is '[NONE AT THIS INDEX]'.

Hinweise

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

Das Abfrageverhalten, das als Ergebnis der Ausführung einer Ausdrucksstruktur auftritt, die aufruft ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) , hängt von der Implementierung des Typs des source Parameters ab. Das erwartete Verhalten ist, dass es das Element an der Position index in sourceoder default(TSource) außerhalb index der Grenzen von source.

Gilt für: