QueryableExtensions.FirstOrDefaultAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>) |
异步返回序列的第一个元素;如果序列不包含任何元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
异步返回满足指定条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
异步返回序列的第一个元素;如果序列不包含任何元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
异步返回满足指定条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>)
异步返回序列的第一个元素;如果序列不包含任何元素,则返回默认值。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)
类型参数
- TSource
的元素 source的类型。
参数
- source
- IQueryable<TSource>
要返回的第一个元素的 A IQueryable<T> 。
返回
表示异步操作的任务。
如果为空,则任务结果包含 default ( TSource ),source否则为第一个元素。source
例外
source is
null。
source 不实现 IDbAsyncQueryProvider 。
注解
不支持对同一上下文实例执行多个活动操作。 使用“await”确保在在此上下文上调用其他方法之前已完成任何异步操作。
适用于
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
异步返回满足指定条件的序列的第一个元素;如果未找到此类元素,则返回默认值。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)
类型参数
- TSource
的元素 source的类型。
参数
- source
- IQueryable<TSource>
要返回的第一个元素的 A IQueryable<T> 。
- predicate
- Expression<Func<TSource,Boolean>>
用于测试条件的每个元素的函数。
返回
表示异步操作的任务。
如果任务结果为空,或者没有元素通过指定的测试,则为
- 特性
例外
source 或
predicate is
null。
source 不实现 IDbAsyncQueryProvider 。
注解
不支持对同一上下文实例执行多个活动操作。 使用“await”确保在在此上下文上调用其他方法之前已完成任何异步操作。
适用于
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
异步返回序列的第一个元素;如果序列不包含任何元素,则返回默认值。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
类型参数
- TSource
的元素 source的类型。
参数
- source
- IQueryable<TSource>
要返回的第一个元素的 A IQueryable<T> 。
- cancellationToken
- CancellationToken
等待任务完成时观察的 A CancellationToken 。
返回
表示异步操作的任务。
如果为空,则任务结果包含 default ( TSource ),source否则为第一个元素。source
例外
source is
null。
source 不实现 IDbAsyncQueryProvider 。
注解
不支持对同一上下文实例执行多个活动操作。 使用“await”确保在在此上下文上调用其他方法之前已完成任何异步操作。
适用于
FirstOrDefaultAsync<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> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
类型参数
- TSource
的元素 source的类型。
参数
- source
- IQueryable<TSource>
要返回的第一个元素的 A IQueryable<T> 。
- predicate
- Expression<Func<TSource,Boolean>>
用于测试条件的每个元素的函数。
- cancellationToken
- CancellationToken
等待任务完成时观察的 A CancellationToken 。
返回
表示异步操作的任务。
如果任务结果为空,或者没有元素通过指定的测试,则为
- 特性
例外
source 或
predicate is
null。
source 具有多个元素。
注解
不支持对同一上下文实例执行多个活动操作。 使用“await”确保在在此上下文上调用其他方法之前已完成任何异步操作。