DbRawSqlQuery<TElement>.SingleAsync 方法

定義

命名空間:

System.Data.Entity.Infrastructure

組件:

EntityFramework.dll

多載

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

SingleAsync()

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

public System.Threading.Tasks.Task<TElement> SingleAsync ();

member this.SingleAsync : unit -> System.Threading.Tasks.Task<'Element>

Public Function SingleAsync () As Task(Of TElement)

傳回

Task<TElement>

代表非同步作業的工作。 工作結果包含查詢結果的單一元素。

例外狀況

InvalidOperationException

查詢結果是空的。

備註

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

SingleAsync(Func<TElement,Boolean>)

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

public System.Threading.Tasks.Task<TElement> SingleAsync (Func<TElement,bool> predicate);

member this.SingleAsync : Func<'Element, bool> -> System.Threading.Tasks.Task<'Element>

Public Function SingleAsync (predicate As Func(Of TElement, Boolean)) As Task(Of TElement)

參數

predicate

Func<TElement,Boolean>

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

傳回

Task<TElement>

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

例外狀況

ArgumentNullException

predicate 是 null .

InvalidOperationException

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

備註

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

SingleAsync(CancellationToken)

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

public System.Threading.Tasks.Task<TElement> SingleAsync (System.Threading.CancellationToken cancellationToken);

member this.SingleAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>

參數

cancellationToken

CancellationToken

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

傳回

Task<TElement>

代表非同步作業的工作。 工作結果包含查詢結果的單一元素。

例外狀況

InvalidOperationException

查詢結果是空的。

備註

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

SingleAsync(Func<TElement,Boolean>, CancellationToken)

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

public System.Threading.Tasks.Task<TElement> SingleAsync (Func<TElement,bool> predicate, System.Threading.CancellationToken cancellationToken);

member this.SingleAsync : Func<'Element, bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>

參數

predicate

Func<TElement,Boolean>

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

cancellationToken

CancellationToken

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

傳回

Task<TElement>

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

例外狀況

ArgumentNullException

predicate 是 null .

InvalidOperationException

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

備註

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