Queryable.First メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.Queryable.dll

シーケンスの最初の要素を返します。

オーバーロード

First<TSource>(IQueryable<TSource>)	シーケンスの最初の要素を返します。
First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	指定された条件を満たす、シーケンスの最初の要素を返します。

First<TSource>(IQueryable<TSource>)

ソース:

Queryable.cs

シーケンスの最初の要素を返します。

C#

public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source);

型パラメーター

TSource

source の要素の型。

パラメーター

source

IQueryable<TSource>

最初の要素を返す IQueryable<T>。

戻り値

TSource

source の最初の要素。

例外

ArgumentNullException

source が nullです。

InvalidOperationException

ソース シーケンスが空です。

例

次のコード例では、 を使用 First<TSource>(IQueryable<TSource>) してシーケンス内の最初の要素を返す方法を示します。

C#

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.AsQueryable().First();

Console.WriteLine(first);

/*
    This code produces the following output:

    9
*/

注釈

メソッドは First<TSource>(IQueryable<TSource>) 、 MethodCallExpression 構築されたジェネリック メソッドとしての呼び出し First<TSource>(IQueryable<TSource>) 自体を表す を生成します。 次に、 パラメーターの MethodCallExpressionExecute<TResult>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。

呼び出し First<TSource>(IQueryable<TSource>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、 の source最初の要素を返すということです。

First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

ソース:

Queryable.cs

指定された条件を満たす、シーケンスの最初の要素を返します。

C#

public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);

型パラメーター

TSource

source の要素の型。

パラメーター

source

IQueryable<TSource>

返される要素が含まれる IQueryable<T>。

predicate

Expression<Func<TSource,Boolean>>

各要素が条件を満たしているかどうかをテストする関数。

戻り値

TSource

source でテストに合格する、predicate の最初の要素。

例外

ArgumentNullException

source または predicate が null です。

InvalidOperationException

predicate の条件を満たす要素はありません。

- または -

ソース シーケンスが空です。

例

次のコード例では、 を使用 First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) して、条件を満たすシーケンスの最初の要素を返す方法を示します。

C#

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                  83, 23, 87, 435, 67, 12, 19 };

// Get the first number in the array that is greater than 80.
int first = numbers.AsQueryable().First(number => number > 80);

Console.WriteLine(first);

/*
    This code produces the following output:

    92
*/

注釈

このメソッドには、型引数が型 Expression<TDelegate> の 1 つである型のパラメーターが少なくとも 1 つ Func<T,TResult> 含まれています。 これらのパラメーターでは、ラムダ式を渡すと、 に Expression<TDelegate>コンパイルされます。

メソッドは First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) 、 MethodCallExpression 構築されたジェネリック メソッドとしての呼び出し First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) 自体を表す を生成します。 次に、 パラメーターの MethodCallExpressionExecute<TResult>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。

呼び出し First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、 でpredicate指定された条件を満たす のsource最初の要素を返すということです。