Queryable.First メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
シーケンスの最初の要素を返します。
オーバーロード
First<TSource>(IQueryable<TSource>) |
シーケンスの最初の要素を返します。 |
First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
指定された条件を満たす、シーケンスの最初の要素を返します。 |
First<TSource>(IQueryable<TSource>)
- ソース:
- Queryable.cs
- ソース:
- Queryable.cs
- ソース:
- Queryable.cs
シーケンスの最初の要素を返します。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource First(System::Linq::IQueryable<TSource> ^ source);
public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source);
static member First : System.Linq.IQueryable<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource)) As TSource
型パラメーター
- TSource
source
の要素の型。
パラメーター
- source
- IQueryable<TSource>
最初の要素を返す IQueryable<T>。
戻り値
source
の最初の要素。
例外
source
が null
です。
ソース シーケンスが空です。
例
次のコード例では、 を使用 First<TSource>(IQueryable<TSource>) してシーケンス内の最初の要素を返す方法を示します。
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
*/
Dim numbers() As Integer = {9, 34, 65, 92, 87, 435, 3, 54, _
83, 23, 87, 435, 67, 12, 19}
Dim first As Integer = numbers.AsQueryable().First()
MsgBox(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
- ソース:
- Queryable.cs
- ソース:
- Queryable.cs
指定された条件を満たす、シーケンスの最初の要素を返します。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource First(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);
public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member First : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As TSource
型パラメーター
- TSource
source
の要素の型。
パラメーター
- source
- IQueryable<TSource>
返される要素が含まれる IQueryable<T>。
- predicate
- Expression<Func<TSource,Boolean>>
各要素が条件を満たしているかどうかをテストする関数。
戻り値
source
でテストに合格する、predicate
の最初の要素。
例外
source
または predicate
が null
です。
例
次のコード例では、 を使用 First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) して、条件を満たすシーケンスの最初の要素を返す方法を示します。
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
*/
Dim numbers() As Integer = {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.
Dim first As Integer = numbers.AsQueryable().First(Function(number) number > 80)
MsgBox(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
最初の要素を返すということです。
適用対象
.NET