QueryableExtensions.SingleOrDefaultAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию или значению по умолчанию, если такого элемента не существует; Этот метод создает исключение, если условию удовлетворяет несколько элементов. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Асинхронно возвращает единственный элемент последовательности или значение по умолчанию, если последовательность пуста; Этот метод создает исключение, если в последовательности имеется несколько элементов. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>) |
Асинхронно возвращает единственный элемент последовательности или значение по умолчанию, если последовательность пуста; Этот метод создает исключение, если в последовательности имеется несколько элементов. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию или значению по умолчанию, если такого элемента не существует; Этот метод создает исключение, если условию удовлетворяет несколько элементов. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию или значению по умолчанию, если такого элемента не существует; Этот метод создает исключение, если условию удовлетворяет несколько элементов.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
- predicate
- Expression<Func<TSource,Boolean>>
Функция для проверки элемента на соответствие условию.
- cancellationToken
- CancellationToken
Объект для CancellationToken наблюдения во время ожидания завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Результат задачи содержит один элемент входной последовательности, удовлетворяющий условию в predicate, или default ( TSource ), если такой элемент не найден.
- Атрибуты
Исключения
source илиpredicate имеет значениеnull .
source не реализует IDbAsyncQueryProvider .
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте "await", чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте.
Применяется к
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Асинхронно возвращает единственный элемент последовательности или значение по умолчанию, если последовательность пуста; Этот метод создает исключение, если в последовательности имеется несколько элементов.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
- cancellationToken
- CancellationToken
Объект для CancellationToken наблюдения во время ожидания завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Результат задачи содержит один элемент входной последовательности или default (TSource), если последовательность не содержит элементов.
Исключения
source имеет значениеnull .
source имеет более одного элемента.
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте "await", чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте.
Применяется к
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)
Асинхронно возвращает единственный элемент последовательности или значение по умолчанию, если последовательность пуста; Этот метод создает исключение, если в последовательности имеется несколько элементов.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Результат задачи содержит один элемент входной последовательности или default (TSource), если последовательность не содержит элементов.
Исключения
source имеет значениеnull .
source имеет более одного элемента.
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте "await", чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте.
Применяется к
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
Асинхронно возвращает единственный элемент последовательности, удовлетворяющий указанному условию или значению по умолчанию, если такого элемента не существует; Этот метод создает исключение, если условию удовлетворяет несколько элементов.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)Параметры типа
- TSource
Тип элементов source.
Параметры
- source
- IQueryable<TSource>
Объект IQueryable<T>, единственный элемент которого требуется возвратить.
- predicate
- Expression<Func<TSource,Boolean>>
Функция для проверки элемента на соответствие условию.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Результат задачи содержит один элемент входной последовательности, удовлетворяющий условию в predicate, или default ( TSource ), если такой элемент не найден.
- Атрибуты
Исключения
source илиpredicate имеет значениеnull .
source не реализует IDbAsyncQueryProvider .
Комментарии
Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте "await", чтобы убедиться, что все асинхронные операции завершены перед вызовом другого метода в этом контексте.
Применяется к
Entity Framework
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по