EntityFrameworkQueryableExtensions.SingleAsync 方法

定義

命名空間:

Microsoft.EntityFrameworkCore

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v9.0.0

多載

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的唯一元素，如果序列中沒有任何元素，則會擲回例外狀況。
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回符合指定條件之序列的唯一元素，如果有多個這類專案存在，則會擲回例外狀況。

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

來源:

EntityFrameworkQueryableExtensions.cs

以非同步方式傳回序列的唯一元素，如果序列中沒有任何元素，則會擲回例外狀況。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

要傳回單一項目的 IQueryable<T>。

cancellationToken

CancellationToken

CancellationToken等候工作完成時要觀察的 。

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含輸入序列的單一元素。

例外狀況

ArgumentNullException

source 為 null。

InvalidOperationException

source 包含多個元素。

-或-

source 沒有包含任何項目。

OperationCanceledException

如果取消 CancellationToken。

備註

不支援相同內容實例上的多個作用中作業。 使用 await 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。 如需詳細資訊和範例 ，請參閱避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 EF Core 查詢資料 。

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

來源:

EntityFrameworkQueryableExtensions.cs

以非同步方式傳回符合指定條件之序列的唯一元素，如果有多個這類專案存在，則會擲回例外狀況。

C#

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);

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

要傳回單一項目的 IQueryable<T>。

predicate

Expression<Func<TSource,Boolean>>

用來測試項目是否符合條件的函式。

cancellationToken

CancellationToken

CancellationToken等候工作完成時要觀察的 。

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含符合 中 predicate 條件之輸入序列的單一元素。

例外狀況

ArgumentNullException

source 或 predicate 為 null。

InvalidOperationException

沒有任何項目符合 predicate 的條件。

-或-

超過一個項目符合 predicate 中的條件。

-或-

source 沒有包含任何項目。

OperationCanceledException

如果取消 CancellationToken。

備註

不支援相同內容實例上的多個作用中作業。 使用 await 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。 如需詳細資訊和範例 ，請參閱避免 DbCoNtext 執行緒問題 。

如需詳細資訊和範例，請參閱 使用 EF Core 查詢資料 。