AsyncEnumerable.ElementAtOrDefaultAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| ElementAtOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Index, CancellationToken) |
傳回序列中指定索引處的專案，如果索引超出範圍，則傳回預設值。 |
| ElementAtOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Int32, CancellationToken) |
在序列中回傳指定索引的元素，若索引超出範圍則回傳預設值。 |
ElementAtOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Index, CancellationToken)
傳回序列中指定索引處的專案，如果索引超出範圍，則傳回預設值。
public static System.Threading.Tasks.ValueTask<TSource?> ElementAtOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, Index index, System.Threading.CancellationToken cancellationToken = default);static member ElementAtOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * Index * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function ElementAtOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), index As Index, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)類型參數
- TSource
元素 source的類型。
參數
- source
- IAsyncEnumerable<TSource>
一個 IAsyncEnumerable<T> 還原元素的來源。
- index
- Index
要檢索的元素索引，從起點或結束點開始。
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。 預設值為 None。
傳回
ValueTask<TSource>
default 若 index 不在序列的 source 邊界之外;否則，該元素位於序列中 source 指定位置。
例外狀況
source 是 null。
備註
若 的 source 實作類型為 IList<T>，則該實作用於取得指定索引的元素。 否則，此方法會得到指定的元素。
參考型態與可空型態的預設值為 null。
適用於
ElementAtOrDefaultAsync<TSource>(IAsyncEnumerable<TSource>, Int32, CancellationToken)
在序列中回傳指定索引的元素，若索引超出範圍則回傳預設值。
public static System.Threading.Tasks.ValueTask<TSource?> ElementAtOrDefaultAsync<TSource>(this System.Collections.Generic.IAsyncEnumerable<TSource> source, int index, System.Threading.CancellationToken cancellationToken = default);static member ElementAtOrDefaultAsync : System.Collections.Generic.IAsyncEnumerable<'Source> * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Source><Extension()>
Public Function ElementAtOrDefaultAsync(Of TSource) (source As IAsyncEnumerable(Of TSource), index As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TSource)類型參數
- TSource
來源元素的類型。
參數
- source
- IAsyncEnumerable<TSource>
一個 IAsyncEnumerable<T> 還原元素的來源。
- index
- Int32
要檢索的元素索引，從序列的起點或結尾開始。
- cancellationToken
- CancellationToken
CancellationToken他們需要監控取消申請。 預設值為 None。
傳回
ValueTask<TSource>
若 TSource 不在來源序列的邊界之外，則index預設值為 ;否則，該元素位於來源序列中指定位置。
例外狀況
source 是 null。
