EntityFrameworkQueryableExtensions.FirstAsync 方法

定義

命名空間:

Microsoft.EntityFrameworkCore

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v10.0.0

多載

名稱	Description
FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)	非同步回傳序列的第一個元素。
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	非同步回傳滿足特定條件的序列中第一個元素。

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

來源:

EntityFrameworkQueryableExtensions.cs

非同步回傳序列的第一個元素。

public static System.Threading.Tasks.Task<TSource> FirstAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member FirstAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function FirstAsync(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 在等待任務完成時觀察。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含 中的 source第一個元素。

例外狀況

ArgumentNullException

source 是 null。

InvalidOperationException

source 不含任何元素。

OperationCanceledException

如果取消了 CancellationToken 。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中，請用 await 以確認所有非同步操作已完成，然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參閱使用 EF Core 查詢資料 。

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

來源:

EntityFrameworkQueryableExtensions.cs

非同步回傳滿足特定條件的序列中第一個元素。

public static System.Threading.Tasks.Task<TSource> FirstAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);

static member FirstAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function FirstAsync(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 在等待任務完成時觀察。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含第一個通過測試的predicate元素source。

例外狀況

ArgumentNullException

source 或 predicatenull。

InvalidOperationException

沒有任何元素滿足 的條件 predicate

-或者 -

source 不含任何元素。

OperationCanceledException

如果取消了 CancellationToken 。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中，請用 await 以確認所有非同步操作已完成，然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參閱使用 EF Core 查詢資料 。