DbRawSqlQuery<TElement>.FirstOrDefaultAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| FirstOrDefaultAsync() |
非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。 |
| FirstOrDefaultAsync(Func<TElement,Boolean>) |
非同步回傳查詢中第一個符合指定條件的元素,若未找到該元素則回傳預設值。 |
| FirstOrDefaultAsync(CancellationToken) |
非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。 |
| FirstOrDefaultAsync(Func<TElement,Boolean>, CancellationToken) |
非同步回傳查詢中第一個符合指定條件的元素,若未找到該元素則回傳預設值。 |
FirstOrDefaultAsync()
非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。
public System.Threading.Tasks.Task<TElement> FirstOrDefaultAsync();
member this.FirstOrDefaultAsync : unit -> System.Threading.Tasks.Task<'Element>
Public Function FirstOrDefaultAsync () As Task(Of TElement)
傳回
一個代表非同步操作的任務。
若查詢結果為空,則任務結果包含 default ( TElement ) ;否則,為查詢結果中的第一個元素。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
FirstOrDefaultAsync(Func<TElement,Boolean>)
非同步回傳查詢中第一個符合指定條件的元素,若未找到該元素則回傳預設值。
public System.Threading.Tasks.Task<TElement> FirstOrDefaultAsync(Func<TElement,bool> predicate);
member this.FirstOrDefaultAsync : Func<'Element, bool> -> System.Threading.Tasks.Task<'Element>
Public Function FirstOrDefaultAsync (predicate As Func(Of TElement, Boolean)) As Task(Of TElement)
參數
傳回
一個代表非同步操作的任務。
若查詢結果為空或無元素通過由 指定的predicate測試,則任務結果包含 default ( TElement ) ;否則,則為查詢結果中第一個通過由 predicate 所指定的測試的元素。
例外狀況
predicate 是
null .
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
FirstOrDefaultAsync(CancellationToken)
非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。
public System.Threading.Tasks.Task<TElement> FirstOrDefaultAsync(System.Threading.CancellationToken cancellationToken);
member this.FirstOrDefaultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>
參數
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
若查詢結果為空,則任務結果包含 default ( TElement ) ;否則,為查詢結果中的第一個元素。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
FirstOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)
非同步回傳查詢中第一個符合指定條件的元素,若未找到該元素則回傳預設值。
public System.Threading.Tasks.Task<TElement> FirstOrDefaultAsync(Func<TElement,bool> predicate, System.Threading.CancellationToken cancellationToken);
member this.FirstOrDefaultAsync : Func<'Element, bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Element>
參數
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
若查詢結果為空或無元素通過由 指定的predicate測試,則任務結果包含 default ( TElement ) ;否則,則為查詢結果中第一個通過由 predicate 所指定的測試的元素。
例外狀況
predicate 是
null .
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。