QueryableExtensions.SingleOrDefaultAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
指定した条件を満たすシーケンスの唯一の要素、またはそのような要素が存在しない場合は既定値を非同期的に返します。このメソッドは、複数の要素が条件を満たす場合に例外をスローします。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
シーケンスの唯一の要素を非同期的に返します。シーケンスが空の場合は既定値を返します。シーケンスに複数の要素がある場合、このメソッドは例外をスローします。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>) |
シーケンスの唯一の要素を非同期的に返します。シーケンスが空の場合は既定値を返します。シーケンスに複数の要素がある場合、このメソッドは例外をスローします。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
指定した条件を満たすシーケンスの唯一の要素、またはそのような要素が存在しない場合は既定値を非同期的に返します。このメソッドは、複数の要素が条件を満たす場合に例外をスローします。 |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
指定した条件を満たすシーケンスの唯一の要素、またはそのような要素が存在しない場合は既定値を非同期的に返します。このメソッドは、複数の要素が条件を満たす場合に例外をスローします。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
1 つの要素を返す IQueryable<T>。
- predicate
- Expression<Func<TSource,Boolean>>
要素が条件を満たしているかどうかをテストする関数。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期操作を表すタスク。
タスクの結果には、 の条件 predicateを満たす入力シーケンスの 1 つの要素が含まれます。このような default 要素が見つからない場合は 、 ( TSource ) です。
- 属性
例外
source またはpredicate がnull .
source は を実装 IDbAsyncQueryProvider しません。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、'await' を使用します。
適用対象
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
シーケンスの唯一の要素を非同期的に返します。シーケンスが空の場合は既定値を返します。シーケンスに複数の要素がある場合、このメソッドは例外をスローします。
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
1 つの要素を返す IQueryable<T>。
- cancellationToken
- CancellationToken
CancellationTokenタスクの完了を待機している間に観察する 。
戻り値
非同期操作を表すタスク。
タスクの結果には、入力シーケンスの 1 つの要素が含まれます。シーケンス default に要素が含まれない場合は (TSource) です。
例外
source がnull .
source には複数の要素があります。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、'await' を使用します。
適用対象
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)
シーケンスの唯一の要素を非同期的に返します。シーケンスが空の場合は既定値を返します。シーケンスに複数の要素がある場合、このメソッドは例外をスローします。
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
1 つの要素を返す IQueryable<T>。
戻り値
非同期操作を表すタスク。
タスクの結果には、入力シーケンスの 1 つの要素が含まれます。シーケンス default に要素が含まれない場合は (TSource) です。
例外
source がnull .
source には複数の要素があります。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、'await' を使用します。
適用対象
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
指定した条件を満たすシーケンスの唯一の要素、またはそのような要素が存在しない場合は既定値を非同期的に返します。このメソッドは、複数の要素が条件を満たす場合に例外をスローします。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)型パラメーター
- TSource
source の要素の型。
パラメーター
- source
- IQueryable<TSource>
1 つの要素を返す IQueryable<T>。
- predicate
- Expression<Func<TSource,Boolean>>
要素が条件を満たしているかどうかをテストする関数。
戻り値
非同期操作を表すタスク。
タスクの結果には、 の条件 predicateを満たす入力シーケンスの 1 つの要素が含まれます。このような default 要素が見つからない場合は 、 ( TSource ) です。
- 属性
例外
source またはpredicate がnull .
source は を実装 IDbAsyncQueryProvider しません。
注釈
同じコンテキスト インスタンスに対する複数のアクティブな操作はサポートされていません。 このコンテキストで別のメソッドを呼び出す前に非同期操作が完了したことを確認するには、'await' を使用します。
適用対象
Entity Framework
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示