DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法

定义

命名空间:

System.Data.Entity.Infrastructure

程序集:

EntityFramework.dll

重载

SingleOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)	异步返回查询中唯一满足指定条件的元素;如果不存在此类元素，则返回默认值;如果多个元素满足条件，此方法将引发异常。
SingleOrDefaultAsync(CancellationToken)	异步返回序列的唯一元素，如果序列为空，则返回默认值;如果序列中有多个元素，此方法将引发异常。
SingleOrDefaultAsync()	异步返回序列的唯一元素，如果序列为空，则返回默认值;如果序列中有多个元素，此方法将引发异常。
SingleOrDefaultAsync(Func<TElement,Boolean>)	异步返回查询中唯一满足指定条件的元素;如果不存在此类元素，则返回默认值;如果多个元素满足条件，此方法将引发异常。

SingleOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)

异步返回查询中唯一满足指定条件的元素;如果不存在此类元素，则返回默认值;如果多个元素满足条件，此方法将引发异常。

public System.Threading.Tasks.Task<TElement> SingleOrDefaultAsync (Func<TElement,bool> predicate, System.Threading.CancellationToken cancellationToken);

member this.SingleOrDefaultAsync : Func<'Element, bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>

参数

predicate

Func<TElement,Boolean>

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

cancellationToken

CancellationToken

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

返回

Task<TElement>

表示异步操作的任务。 任务结果包含满足 中的 predicate条件的查询结果的单个元素; default 如果未找到此类元素，则 ( TElement ) 。

例外

ArgumentNullException

predicate null .

InvalidOperationException

多个元素满足 中的条件 predicate .

注解

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

SingleOrDefaultAsync(CancellationToken)

异步返回序列的唯一元素，如果序列为空，则返回默认值;如果序列中有多个元素，此方法将引发异常。

public System.Threading.Tasks.Task<TElement> SingleOrDefaultAsync (System.Threading.CancellationToken cancellationToken);

member this.SingleOrDefaultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>

参数

cancellationToken

CancellationToken

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

返回

Task<TElement>

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

例外

InvalidOperationException

查询结果具有多个元素。

注解

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

SingleOrDefaultAsync()

异步返回序列的唯一元素，如果序列为空，则返回默认值;如果序列中有多个元素，此方法将引发异常。

public System.Threading.Tasks.Task<TElement> SingleOrDefaultAsync ();

member this.SingleOrDefaultAsync : unit -> System.Threading.Tasks.Task<'Element>

Public Function SingleOrDefaultAsync () As Task(Of TElement)

返回

Task<TElement>

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

例外

InvalidOperationException

查询结果具有多个元素。

注解

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

SingleOrDefaultAsync(Func<TElement,Boolean>)

异步返回查询中唯一满足指定条件的元素;如果不存在此类元素，则返回默认值;如果多个元素满足条件，此方法将引发异常。

public System.Threading.Tasks.Task<TElement> SingleOrDefaultAsync (Func<TElement,bool> predicate);

member this.SingleOrDefaultAsync : Func<'Element, bool> -> System.Threading.Tasks.Task<'Element>

Public Function SingleOrDefaultAsync (predicate As Func(Of TElement, Boolean)) As Task(Of TElement)

参数

predicate

Func<TElement,Boolean>

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

返回

Task<TElement>

表示异步操作的任务。 任务结果包含满足 中的 predicate条件的查询结果的单个元素; default 如果未找到此类元素，则 ( TElement ) 。

例外

ArgumentNullException

predicate null .

InvalidOperationException

多个元素满足 中的条件 predicate .

注解

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