Queryable.ElementAtOrDefault 方法

定義

命名空間:

System.Linq

組件:

System.Linq.Queryable.dll

多載

ElementAtOrDefault<TSource>(IQueryable<TSource>, Index)	傳回位於序列中指定索引處的元素；如果索引超出範圍，則傳回預設值。
ElementAtOrDefault<TSource>(IQueryable<TSource>, Int32)	傳回位於序列中指定索引處的元素；如果索引超出範圍，則傳回預設值。

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

來源:

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 。

例外狀況

ArgumentNullException

source 為 null。

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

來源:

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

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

default如果 位於的界限外，TSource () index;否則，位於 中指定位置的專案source。source

例外狀況

ArgumentNullException

source 為 null。

範例

下列程式碼範例將示範如何使用 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表示的方法IQueryProvidersource。

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