語言

QueryableExtensions.FirstOrDefaultAsync 方法

定義

多載

名稱 Description
FirstOrDefaultAsync<TSource>(IQueryable<TSource>)

非同步回傳序列的第一個元素,若序列中沒有元素則回傳預設值。

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

非同步回傳序列中第一個符合指定條件的元素,若未找到該元素則回傳預設值。

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

非同步回傳序列的第一個元素,若序列中沒有元素則回傳預設值。

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

非同步回傳序列中第一個符合指定條件的元素,若未找到該元素則回傳預設值。

FirstOrDefaultAsync<TSource>(IQueryable<TSource>)

非同步回傳序列的第一個元素,若序列中沒有元素則回傳預設值。

public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

IQueryable<T>然後回歸第一個元素。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含 default ( TSource ) 若為 source 空;否則,任務中第一個元素 source。

例外狀況

source 是 null .

備註

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

適用於

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

非同步回傳序列中第一個符合指定條件的元素,若未找到該元素則回傳預設值。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

IQueryable<T>然後回歸第一個元素。

predicate
Expression<Func<TSource,Boolean>>

一個用來測試每個元素條件的函數。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含 default ( ),若為source空或無元素通過由 predicate 所指定的測試;否則,第一個通過由 predicate所指定的測試的元素 sourceTSource 。

屬性

例外狀況

source 或 predicate 是 null .

備註

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

適用於

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

非同步回傳序列的第一個元素,若序列中沒有元素則回傳預設值。

public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

IQueryable<T>然後回歸第一個元素。

cancellationToken
CancellationToken

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

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含 default ( TSource ) 若為 source 空;否則,任務中第一個元素 source。

例外狀況

source 是 null .

備註

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

適用於

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

非同步回傳序列中第一個符合指定條件的元素,若未找到該元素則回傳預設值。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
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);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

IQueryable<T>然後回歸第一個元素。

predicate
Expression<Func<TSource,Boolean>>

一個用來測試每個元素條件的函數。

cancellationToken
CancellationToken

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

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含 default ( ),若為source空或無元素通過由 predicate 所指定的測試;否則,第一個通過由 predicate所指定的測試的元素 sourceTSource 。

屬性

例外狀況

source 或 predicate 是 null .

source 有多個元素。

備註

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

適用於