DbRawSqlQuery<TElement>.SingleOrDefaultAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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>
參數
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含查詢結果中滿足條件 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 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含查詢結果的單一元素,若 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)
傳回
一個代表非同步操作的任務。
任務結果包含查詢結果的單一元素,若 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的唯一元素,若 default 未找到該元素則為( TElement )。
例外狀況
predicate 是
null .
多個元素滿足以下條件
predicate .
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。