EntityFrameworkQueryableExtensions.SingleAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

包:

Microsoft.EntityFrameworkCore v10.0.0

重载

名称	说明
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	异步返回序列的唯一元素，如果序列中没有完全一个元素，则会引发异常。
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	异步返回满足指定条件的序列的唯一元素，如果存在多个此类元素，则会引发异常。

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Source:

EntityFrameworkQueryableExtensions.cs

异步返回序列的唯一元素，如果序列中没有完全一个元素，则会引发异常。

public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member SingleAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)

类型参数

TSource

的元素 source的类型。

参数

source

IQueryable<TSource>

一个返回 /> 的单个元素。

cancellationToken

CancellationToken

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

返回

Task<TSource>

表示异步作的任务。 任务结果包含输入序列的单个元素。

例外

ArgumentNullException

source 是 null。

InvalidOperationException

source 包含多个元素。

-或-

source 不包含任何元素。

OperationCanceledException

如果取消了该操作 CancellationToken 。

注解

不支持对同一上下文实例执行多个活动操作。 用于 await 确保在在此上下文上调用其他方法之前已完成任何异步操作。 有关详细信息和示例，请参阅 避免 DbContext 线程问题 。

有关详细信息和示例，请参阅 使用 EF Core 查询数据 。

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Source:

EntityFrameworkQueryableExtensions.cs

异步返回满足指定条件的序列的唯一元素，如果存在多个此类元素，则会引发异常。

public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);

static member SingleAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)

类型参数

TSource

的元素 source的类型。

参数

source

IQueryable<TSource>

一个返回 /> 的单个元素。

predicate

Expression<Func<TSource,Boolean>>

用于测试条件元素的函数。

cancellationToken

CancellationToken

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

返回

Task<TSource>

表示异步作的任务。 任务结果包含满足条件的 predicate输入序列的单个元素。

例外

ArgumentNullException

source 或 predicate 为 null.

InvalidOperationException

没有元素满足条件。predicate

-或-

多个元素满足条件。predicate

-或-

source 不包含任何元素。

OperationCanceledException

如果取消了该操作 CancellationToken 。

注解

不支持对同一上下文实例执行多个活动操作。 用于 await 确保在在此上下文上调用其他方法之前已完成任何异步操作。 有关详细信息和示例，请参阅 避免 DbContext 线程问题 。

有关详细信息和示例，请参阅 使用 EF Core 查询数据 。