DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法

定義

命名空間:

System.Data.Entity.Infrastructure

組件:

EntityFramework.dll

多載

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

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

傳回

Task<TElement>

代表非同步作業的工作。 工作結果包含符合 中 predicate 條件的單一查詢結果元素，如果 default 找不到這類專案，則 ( ) TElement 。

例外狀況

ArgumentNullException

predicate 是 null .

InvalidOperationException

多個元素符合 中的條件 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

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

傳回

Task<TElement>

代表非同步作業的工作。 工作結果包含查詢結果的單一元素，如果 default 序列不包含任何專案，則 (TElement) 。

例外狀況

InvalidOperationException

查詢結果有多個元素。

備註

不支援相同內容實例上的多個作用中作業。 使用 '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>

代表非同步作業的工作。 工作結果包含查詢結果的單一元素，如果 default 序列不包含任何專案，則 (TElement) 。

例外狀況

InvalidOperationException

查詢結果有多個元素。

備註

不支援相同內容實例上的多個作用中作業。 使用 '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 。

例外狀況

ArgumentNullException

predicate 是 null .

InvalidOperationException

多個元素符合 中的條件 predicate .

備註

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