EntityFrameworkQueryableExtensions.FirstOrDefaultAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
シーケンスの最初の要素を非同期的に返します。シーケンスに要素が含まれない場合は既定値を返します。 |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
指定した条件を満たすシーケンスの最初の要素、またはそのような要素が見つからない場合は既定値を非同期に返します。 |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
シーケンスの最初の要素を非同期的に返します。シーケンスに要素が含まれない場合は既定値を返します。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
の IQueryable<T> 最初の要素を返す 。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期操作を表すタスク。
が空の場合source、タスクのdefault結果には ( TSource ) が含まれます。それ以外の場合は、 の最初のsource要素。
例外
source は null です。
CancellationToken が取り消されている場合。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、 を使用 await します。 詳細と例については、「 DbContext スレッドの問題を回避する 」を参照してください。
詳細と例については、「 EF Core を使用したデータのクエリ 」を参照してください。
適用対象
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
指定した条件を満たすシーケンスの最初の要素、またはそのような要素が見つからない場合は既定値を非同期に返します。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
の IQueryable<T> 最初の要素を返す 。
- predicate
- Expression<Func<TSource,Boolean>>
各要素が条件を満たしているかどうかをテストする関数。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期操作を表すタスク。
が空の場合source、または で指定されたpredicateテストに合格する要素がない場合、タスクの結果には ( TSource ) が含まれますdefault。それ以外の場合は、 でpredicate指定されたテストに合格する 内sourceの最初の要素。
例外
source または predicate が null です。
CancellationToken が取り消されている場合。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、 を使用 await します。 詳細と例については、「 DbContext スレッドの問題を回避する 」を参照してください。
詳細と例については、「 EF Core を使用したデータのクエリ 」を参照してください。
適用対象
Entity Framework