AsyncEnumerable.SingleOrDefaultAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| 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.
Возвращаемое значение
Один элемент входной последовательности или значение TSource по умолчанию, если последовательность не содержит элементов.
Исключения
source равно null.
Последовательность 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> возвращаемое одним элементом.
- cancellationToken
- CancellationToken
Мониторинг CancellationToken запросов на отмену. Значение по умолчанию — None.
Возвращаемое значение
Один элемент входной последовательности, удовлетворяющий условию, или значение TSource по умолчанию, если такой элемент не найден.
Исключения
predicate равно null.
Входная последовательность содержит несколько элементов.
Применяется к
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.
Возвращаемое значение
Один элемент входной последовательности, удовлетворяющий условию, или значение TSource по умолчанию, если такой элемент не найден.
Исключения
predicate равно null.
Входная последовательность содержит несколько элементов.
Применяется к
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.
Возвращаемое значение
Один элемент входной последовательности или defaultValue, если последовательность не содержит элементов.
Исключения
source равно null.
Входная последовательность содержит несколько элементов.
Применяется к
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> из который возвращается один элемент.
- defaultValue
- TSource
Значение по умолчанию, возвращаемое, если последовательность пуста.
- cancellationToken
- CancellationToken
Мониторинг CancellationToken запросов на отмену. Значение по умолчанию — None.
Возвращаемое значение
Один элемент входной последовательности, удовлетворяющий условию, или defaultValue, если такой элемент не найден.
Исключения
predicate равно null.
Несколько элементов удовлетворяют условию в 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.
Возвращаемое значение
Один элемент входной последовательности, удовлетворяющий условию, или defaultValue, если такой элемент не найден.
Исключения
predicate равно null.
Несколько элементов удовлетворяют условию в predicate.
