Queryable.ElementAtOrDefault 方法

定義

多載

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

傳回位於序列中指定索引處的元素;如果索引超出範圍,則傳回預設值。

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

傳回位於序列中指定索引處的元素;如果索引超出範圍,則傳回預設值。

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

來源:
Queryable.cs
來源:
Queryable.cs
來源:
Queryable.cs

傳回位於序列中指定索引處的元素;如果索引超出範圍,則傳回預設值。

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);
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

類型參數

TSource

source 項目的類型。

參數

source
IQueryable<TSource>

傳回項目的 IQueryable<T>

index
Index

要擷取的專案索引,這是從開始或結尾。

傳回

TSource

default 如果 index 位於序列的界限 source 之外,則為 ,否則為序列中指定位置的專案 source

例外狀況

sourcenull

適用於

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

來源:
Queryable.cs
來源:
Queryable.cs
來源:
Queryable.cs

傳回位於序列中指定索引處的元素;如果索引超出範圍,則傳回預設值。

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);
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

類型參數

TSource

source 項目的類型。

參數

source
IQueryable<TSource>

傳回項目的 IQueryable<T>

index
Int32

要擷取的項目之以零為起始索引。

傳回

TSource

defaultTSource如果 超出 的界限 source , () index ;否則,位於 中指定位置的專案 source

例外狀況

sourcenull

範例

下列程式碼範例將示範如何使用 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)。 這個範例會使用 超出 index 來源序列界限的值。

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]'.

備註

方法 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) 會產生 , MethodCallExpression 表示 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) 呼叫本身為建構的泛型方法。 然後,它會將 傳遞 MethodCallExpressionExecute<TResult>(Expression) 參數的 屬性所 Provider 表示的 source 方法 IQueryProvider

執行表示呼叫 ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32) 的運算式樹狀結構所產生的查詢行為,取決於參數類型的 source 實作。 預期的行為是它會傳回 位於 中 source 位置 index 的專案,如果 位於 的界限 source 之外,則 default(TSource)index

適用於