語言

DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法

定義

多載

名稱 Description
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

A CancellationToken 在等待任務完成時觀察。

傳回

Task<TElement>

一個代表非同步操作的任務。 任務結果包含查詢結果中滿足條件 predicate的唯一元素,若 default 未找到該元素則為( TElement )。

例外狀況

predicate 是 null .

多個元素滿足以下條件 predicate .

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。

適用於

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

A CancellationToken 在等待任務完成時觀察。

傳回

Task<TElement>

一個代表非同步操作的任務。 任務結果包含查詢結果的單一元素,若 default 序列中沒有元素,則為 (TElement)

例外狀況

查詢結果包含多個元素。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。

適用於

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)

例外狀況

查詢結果包含多個元素。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。

適用於

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

例外狀況

predicate 是 null .

多個元素滿足以下條件 predicate .

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。

適用於