EntityFrameworkQueryableExtensions.FirstOrDefaultAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
非同步回傳序列的第一個元素，若序列中沒有元素則回傳預設值。 |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
非同步回傳序列中第一個符合指定條件的元素，若未找到該元素則回傳預設值。 |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
非同步回傳序列的第一個元素，若序列中沒有元素則回傳預設值。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
IQueryable<T>然後回歸第一個元素。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含 default （ TSource ） 若為 source 空;否則，任務中第一個元素 source。
例外狀況
source 是 null。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中，請用 await 以確認所有非同步操作已完成，然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱使用 EF Core 查詢資料 。
適用於
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
非同步回傳序列中第一個符合指定條件的元素，若未找到該元素則回傳預設值。
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
IQueryable<T>然後回歸第一個元素。
- predicate
- Expression<Func<TSource,Boolean>>
一個用來測試每個元素條件的函數。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含 default （ TSource ），若為 source 空或無元素通過由 predicate所指定的測試，則為 中 source 第一個通過由 所指定的 predicate測試的元素。
例外狀況
source 或 predicate 為 null。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中，請用 await 以確認所有非同步操作已完成，然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱使用 EF Core 查詢資料 。
