AsyncEnumerable.FirstOrDefaultAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken) |
返回满足条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken) |
返回序列的第一个元素;如果序列不包含任何元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken) |
返回满足条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken) |
返回满足条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken) |
返回序列的第一个元素,或者返回序列中不包含任何元素的 |
| FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken) |
返回满足条件的序列的第一个元素;如果未找到此类元素,则返回默认值。 |
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, TSource, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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> 个。
- defaultValue
- TSource
如果序列为空,则返回的默认值。
- cancellationToken
- CancellationToken
要 CancellationToken 监视取消请求。 默认值为 None。
返回
defaultValue 如果 source 为空或者没有元素通过指定的 predicate测试,则为空;否则,该元素中的 source 第一个元素将通过指定的 predicate测试。
例外
predicate 是 null。
适用于
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, TSource, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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。
返回
defaultValue如果source为空,则为 ;否则为第一个元素。source
例外
source 是 null。
适用于
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, TSource, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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。
返回
defaultValue 如果 source 为空或者没有元素通过指定的 predicate测试,则为空;否则,该元素中的 source 第一个元素将通过指定的 predicate测试。
例外
predicate 是 null。
适用于
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,Boolean>, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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> 个。
- cancellationToken
- CancellationToken
要 CancellationToken 监视取消请求。 默认值为 None。
返回
如果源为空或没有元素通过谓词指定的测试,则为默认值 TSource ;否则,源中第一个通过谓词指定的测试的元素。
例外
predicate 是 null。
适用于
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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。
返回
如果source为空的TSource默认值,则为 ;否则为第一个元素。source
例外
source 是 null。
适用于
FirstOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Func<TSource,CancellationToken,ValueTask<Boolean>>, CancellationToken)
- Source:
- FirstAsync.cs
- Source:
- FirstAsync.cs
- Source:
- 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。
返回
如果源为空或没有元素通过谓词指定的测试,则为默认值 TSource ;否则,源中第一个通过谓词指定的测试的元素。
例外
predicate 是 null。