AsyncEnumerable.SingleOrDefaultAsync 方法

定義

命名空間:: System.Linq

組件:: System.Linq.AsyncEnumerable.dll

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

重要

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

多載

名稱	Description
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken)	傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有多個項目，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken)	傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有多個項目，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken)	傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有多個項目，這個方法會擲回例外狀況。

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

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

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

類型參數

TSource

來源元素的類型。

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 回歸單一元素。

cancellationToken: CancellationToken

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

傳回

ValueTask<TSource>

輸入序列的單一元素，或若序列中無元素則為預設值 TSource 。

例外狀況

ArgumentNullException

source 是 null。

InvalidOperationException

該 source 序列包含多個元素。（透過返回任務）

適用於

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。

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

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

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

類型參數

TSource

元素 source的類型。

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 回歸單一元素。

predicate: Func<TSource,Boolean>

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

cancellationToken: CancellationToken

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

傳回

ValueTask<TSource>

輸入序列中滿足條件的唯一元素，若找不到該元素則為預設值 TSource 。

例外狀況

ArgumentNullException

predicate 是 null。

InvalidOperationException

輸入序列包含多個元素。

適用於

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。

public static System.Threading.Tasks.ValueTask<TSource?> SingleOrDefaultAsync<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 SingleOrDefaultAsync : 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 SingleOrDefaultAsync(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的類型。

參數

source: IAsyncEnumerable<TSource>

一個 IAsyncEnumerable<T> 回歸單一元素。

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

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

cancellationToken: CancellationToken

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

傳回

ValueTask<TSource>

輸入序列中滿足條件的唯一元素，若找不到該元素則為預設值 TSource 。

例外狀況

ArgumentNullException

predicate 是 null。

InvalidOperationException

輸入序列包含多個元素。

適用於

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列的唯一專案;如果序列是空的，則傳回預設值;如果序列中有多個項目，這個方法會擲回例外狀況。

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

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

<Extension()>
Public Function SingleOrDefaultAsync(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 若序列中沒有元素。

例外狀況

ArgumentNullException

source 是 null。

InvalidOperationException

輸入序列包含多個元素。

適用於

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。

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

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

<Extension()>
Public Function SingleOrDefaultAsync(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 若找不到此類元素則為該元素。

例外狀況

ArgumentNullException

predicate 是 null。

InvalidOperationException

多個元素滿足該 predicate條件。

適用於

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

來源:: SingleAsync.cs

來源:: SingleAsync.cs

來源:: SingleAsync.cs

傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果一個以上的專案符合條件，這個方法會擲回例外狀況。

public static System.Threading.Tasks.ValueTask<TSource> SingleOrDefaultAsync<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 SingleOrDefaultAsync : 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 SingleOrDefaultAsync(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 若找不到此類元素則為該元素。

例外狀況

ArgumentNullException

predicate 是 null。

InvalidOperationException

多個元素滿足該 predicate條件。

適用於

意見反應

此頁面對您有幫助嗎？