QueryableExtensions.SingleOrDefaultAsync 方法

定義

命名空間:

System.Data.Entity

組件:

EntityFramework.dll

多載

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法會擲回例外狀況。

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

以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法會擲回例外狀況。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken);

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

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

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

predicate

Expression<Func<TSource,Boolean>>

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

cancellationToken

CancellationToken

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

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含輸入序列中符合 條件 predicate 的單一專案，如果 default 找不到這類專案，則 ( ) TSource 。

屬性

SuppressMessageAttribute

例外狀況

ArgumentNullException

source 或predicate 是null .

InvalidOperationException

source 不會實 IDbAsyncQueryProvider 作 。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。

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

以非同步方式傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法會擲回例外狀況。

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

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

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

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

cancellationToken

CancellationToken

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

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含輸入序列的單一專案，如果 default 序列不包含任何專案，則 (TSource) 。

例外狀況

ArgumentNullException

source 是null .

InvalidOperationException

source 具有多個項目。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。

SingleOrDefaultAsync<TSource>(IQueryable<TSource>)

以非同步方式傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法會擲回例外狀況。

public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

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

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含輸入序列的單一專案，如果 default 序列不包含任何專案，則 (TSource) 。

例外狀況

ArgumentNullException

source 是null .

InvalidOperationException

source 具有多個項目。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法會擲回例外狀況。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);

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

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)

類型參數

TSource

source 項目的類型。

參數

source

IQueryable<TSource>

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

predicate

Expression<Func<TSource,Boolean>>

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

傳回

Task<TSource>

代表非同步作業的工作。 工作結果包含輸入序列中符合 條件 predicate 的單一專案，如果 default 找不到這類專案，則 ( ) TSource 。

屬性

SuppressMessageAttribute

例外狀況

ArgumentNullException

source 或predicate 是null .

InvalidOperationException

source 不會實 IDbAsyncQueryProvider 作 。

備註

不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。