AsyncEnumerable.FirstOrDefaultAsync 方法

定義

命名空間:: System.Linq

組件:: System.Linq.AsyncEnumerable.dll

套件:: System.Linq.AsyncEnumerable v11.0.0

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken)	回傳序列的第一個元素，或若序列中無元素則回傳預設值 `TSource` 。
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)	傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)	傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken)	傳回序列的第一個專案，如果序列不包含任何專案，則傳回預設值。
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)	傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken)	傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。

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

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

回傳序列的第一個元素，或若序列中無元素則回傳預設值 TSource 。

public static System.Threading.Tasks.ValueTask<TSource?> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source: IAsyncEnumerable<TSource>

IAsyncEnumerable<T>還原第一個元素。

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

如果TSource為空，則的source預設值為空;否則，第一個元素source為。

例外狀況

ArgumentNullException

source 是 null。

適用於

FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。

public static System.Threading.Tasks.ValueTask<TSource?> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,bool> predicate, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, bool> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 還原元素的來源。

predicate: Func<TSource,Boolean>

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

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

預設值為若 TSource 來源為空或無元素通過謂詞指定的測試;否則，則為來源中第一個通過謂詞指定測試的元素。

例外狀況

ArgumentNullException

predicate 是 null。

適用於

FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。

public static System.Threading.Tasks.ValueTask<TSource?> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,System.Threading.CancellationToken,System.Threading.Tasks.ValueTask<bool>> predicate, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, System.Threading.CancellationToken, System.Threading.Tasks.ValueTask<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, CancellationToken, ValueTask(Of Boolean)), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 還原元素的來源。

predicate: Func<TSource,CancellationToken,ValueTask<Boolean>>

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

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

預設值為若 TSource 來源為空或無元素通過謂詞指定的測試;否則，則為來源中第一個通過謂詞指定測試的元素。

例外狀況

ArgumentNullException

predicate 是 null。

適用於

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

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

傳回序列的第一個專案，如果序列不包含任何專案，則傳回預設值。

public static System.Threading.Tasks.ValueTask<TSource> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source: IAsyncEnumerable<TSource>

IAsyncEnumerable<T>還原第一個元素。

defaultValue: TSource

如果序列為空，則會回傳預設值。

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

defaultValue 若 source 為空;否則，為中的 source第一個元素。

例外狀況

ArgumentNullException

source 是 null。

適用於

FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。

public static System.Threading.Tasks.ValueTask<TSource> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, bool> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 還原元素的來源。

predicate: Func<TSource,Boolean>

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

defaultValue: TSource

如果序列為空，則會回傳預設值。

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

defaultValue若source為空，或無元素通過由 predicate指定的測試;否則，第一個通過由 source所指定的測試的元素predicate。

例外狀況

ArgumentNullException

predicate 是 null。

適用於

FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken)

來源:: FirstAsync.cs

來源:: FirstAsync.cs

來源:: FirstAsync.cs

傳回序列的第一個專案，如果找不到這類專案，則為符合條件或預設值。

public static System.Threading.Tasks.ValueTask<TSource> FirstOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Func<TSource,System.Threading.CancellationToken,System.Threading.Tasks.ValueTask<bool>> predicate, TSource defaultValue, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Func<'Source, System.Threading.CancellationToken, System.Threading.Tasks.ValueTask<bool>> * 'Source * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), predicate As Func(Of TSource, CancellationToken, ValueTask(Of Boolean)), defaultValue As TSource, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)

類型參數

TSource

元素 source的類型。

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 還原元素的來源。

predicate: Func<TSource,CancellationToken,ValueTask<Boolean>>

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

defaultValue: TSource

如果序列為空，則會回傳預設值。

cancellationToken: CancellationToken

CancellationToken他們需要監控取消申請。預設值為 None。

傳回

ValueTask<TSource>

defaultValue若source為空，或無元素通過由 predicate指定的測試;否則，第一個通過由 source所指定的測試的元素predicate。

例外狀況

ArgumentNullException

predicate 是 null。

適用於

意見反應

此頁面對您有幫助嗎？