QueryableExtensions.SingleOrDefaultAsync 方法

定义

命名空间:

System.Data.Entity

程序集:

EntityFramework.dll

重载

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>

要返回其单个元素的 IQueryable<T>。

predicate

Expression<Func<TSource,Boolean>>

用于测试元素是否满足条件的函数。

cancellationToken

CancellationToken

等待 CancellationToken 任务完成时要观察的 。

返回

Task<TSource>

表示异步操作的任务。 任务结果包含满足 中 predicate条件的输入序列的单个元素， default 如果没有找到此类元素，则 ( TSource ) 。

属性

SuppressMessageAttribute

例外

ArgumentNullException

source 或predicatenull .

InvalidOperationException

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>

要返回其单个元素的 IQueryable<T>。

cancellationToken

CancellationToken

等待 CancellationToken 任务完成时要观察的 。

返回

Task<TSource>

表示异步操作的任务。 任务结果包含输入序列的单个元素，如果 default 序列不包含任何元素，则 (TSource) 。

例外

ArgumentNullException

sourcenull .

InvalidOperationException

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>

要返回其单个元素的 IQueryable<T>。

返回

Task<TSource>

表示异步操作的任务。 任务结果包含输入序列的单个元素，如果 default 序列不包含任何元素，则 (TSource) 。

例外

ArgumentNullException

sourcenull .

InvalidOperationException

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>

要返回其单个元素的 IQueryable<T>。

predicate

Expression<Func<TSource,Boolean>>

用于测试元素是否满足条件的函数。

返回

Task<TSource>

表示异步操作的任务。 任务结果包含满足 中 predicate条件的输入序列的单个元素， default 如果没有找到此类元素，则 ( TSource ) 。

属性

SuppressMessageAttribute

例外

ArgumentNullException

source 或predicatenull .

InvalidOperationException

source 不实现 IDbAsyncQueryProvider 。

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。