EntityFrameworkQueryableExtensions.SingleAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| SingleAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Асинхронно возвращает единственный элемент последовательности и создает исключение, если в последовательности нет ни одного элемента. |
| SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию, и создает исключение, если существует несколько таких элементов. |
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)
Асинхронно возвращает единственный элемент последовательности и создает исключение, если в последовательности нет ни одного элемента.
public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member SingleAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
- cancellationToken
- CancellationToken
Объект CancellationToken , который необходимо наблюдать в ожидании завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию. Результат задачи содержит один элемент входной последовательности.
Исключения
source имеет значение null.
source содержит несколько элементов.
-или-
Последовательность source не содержит элементов.
Если CancellationToken отменяется.
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте await , чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте. Дополнительные сведения и примеры см. в статье Предотвращение проблем с потоками DbContext .
Дополнительные сведения и примеры см. в статье Запрос данных с помощью EF Core .
Применяется к
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию, и создает исключение, если существует несколько таких элементов.
public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member SingleAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
- predicate
- Expression<Func<TSource,Boolean>>
Функция для проверки элемента на соответствие условию.
- cancellationToken
- CancellationToken
Объект CancellationToken , который необходимо наблюдать в ожидании завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Результат задачи содержит один элемент входной последовательности, удовлетворяющий условию в predicate.
Исключения
Параметр source или predicate имеет значение null.
Ни один элемент не удовлетворяет условию предиката predicate.
-или-
Условию предиката predicate удовлетворяет более одного элемента.
-или-
Последовательность source не содержит элементов.
Если CancellationToken отменяется.
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте await , чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте. Дополнительные сведения и примеры см. в статье Предотвращение проблем с потоками DbContext .
Дополнительные сведения и примеры см. в статье Запрос данных с помощью EF Core .
Применяется к
Entity Framework