DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法 (Func<TElement, Boolean>, CancellationToken)
[本页针对的是实体框架版本 6。最新版本以“实体框架”NuGet 包的形式提供。有关实体框架的更多信息，请参见 msdn.com/data/ef。]
异步返回满足指定条件的查询的唯一元素；如果这类元素不存在，则返回默认值；如果有多个元素满足该条件，此方法将引发异常。
命名空间： System.Data.Entity.Infrastructure
程序集： EntityFramework（在 EntityFramework.dll 中）
语法
声明
Public Function SingleOrDefaultAsync ( _
predicate As Func(Of TElement, Boolean), _
cancellationToken As CancellationToken _
) As Task(Of TElement)
用法
Dim instance As DbRawSqlQuery
Dim predicate As Func(Of TElement, Boolean)
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of TElement)
returnValue = instance.SingleOrDefaultAsync(predicate, _
cancellationToken)
public Task<TElement> SingleOrDefaultAsync(
Func<TElement, bool> predicate,
CancellationToken cancellationToken
)
public:
Task<TElement>^ SingleOrDefaultAsync(
Func<TElement, bool>^ predicate,
CancellationToken cancellationToken
)
member SingleOrDefaultAsync :
predicate:Func<'TElement, bool> *
cancellationToken:CancellationToken -> Task<'TElement>
public function SingleOrDefaultAsync(
predicate : Func<TElement, boolean>,
cancellationToken : CancellationToken
) : Task<TElement>
参数
- predicate
类型：System.Func<TElement, Boolean>
用于测试每个元素是否满足条件的函数。
- cancellationToken
类型：System.Threading.CancellationToken
等待任务完成期间要观察的 CancellationToken。
返回值
类型：System.Threading.Tasks.Task<TElement>
表示异步操作的任务。任务结果包含满足 predicate 中条件的查询结果的单个元素；如果没有找到这样的元素，则任务结果包含 default (TElement)。
异常
| 例外 | 条件 |
|---|---|
| ArgumentNullException | predicate 为 null。 |
| InvalidOperationException | 多个元素满足 predicate 中的条件。 |
备注
不支持对同一上下文实例执行多个活动操作。 使用“await”以确保在对此上下文调用另一个方法前完成了所有异步操作。