AsyncEnumerable.SingleOrDefaultAsync 方法

定义

命名空间:: System.Linq

程序集:: System.Linq.AsyncEnumerable.dll

包:: System.Linq.AsyncEnumerable v11.0.0-preview.4.26230.115

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

名称	说明
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)

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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>

一个返回 /> 的单个元素。

cancellationToken: CancellationToken

要 CancellationToken 监视取消请求。默认值为 None。

ValueTask<TSource>

输入序列的单个元素，或者如果序列不包含任何元素， TSource 则为默认值。

例外

ArgumentNullException

source 是 null。

InvalidOperationException

序列 source 包含多个元素。（通过返回的任务）。

适用于

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

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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>

一个返回 /> 的单个元素。

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)

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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>

一个返回 /> 的单个元素。

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

用于测试条件元素的函数。

cancellationToken: CancellationToken

要 CancellationToken 监视取消请求。默认值为 None。

ValueTask<TSource>

满足条件的输入序列的单个元素，或者找不到此类元素的 TSource 默认值。

例外

ArgumentNullException

predicate 是 null。

InvalidOperationException

输入序列包含多个元素。

适用于

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

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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>

一个返回 /> 的单个元素。

defaultValue: TSource

如果序列为空，则返回的默认值。

cancellationToken: CancellationToken

要 CancellationToken 监视取消请求。默认值为 None。

ValueTask<TSource>

输入序列的单个元素，或者 defaultValue 序列中不包含任何元素。

例外

ArgumentNullException

source 是 null。

InvalidOperationException

输入序列包含多个元素。

适用于

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

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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)

Source:: SingleAsync.cs

Source:: SingleAsync.cs

Source:: 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

适用于

反馈

此页面是否有帮助？