语言

DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法

定义

重载

名称 说明
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

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

返回

Task<TElement>

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

例外

predicate is null。

多个元素满足条件 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

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

返回

Task<TElement>

表示异步操作的任务。 任务结果包含查询结果的单个元素;如果 序列不包含任何元素,则为 />。

例外

查询结果有多个元素。

注解

不支持对同一上下文实例执行多个活动操作。 使用“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>

表示异步操作的任务。 任务结果包含查询结果的单个元素;如果 序列不包含任何元素,则为 />。

例外

查询结果有多个元素。

注解

不支持对同一上下文实例执行多个活动操作。 使用“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 )。

例外

predicate is null。

多个元素满足条件 predicate。

注解

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

适用于