DbRawSqlQuery<TElement>.SingleOrDefaultAsync - метод (Func<TElement, Boolean>, CancellationToken)
[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]
Возвращает в асинхронном режиме единственный элемент запроса, удовлетворяющий заданному условию, или значение по умолчанию, если таковой элемент не существует; этот метод вызывает исключение, если условию удовлетворяют больше одного элемента.
Пространство имен: System.Data.Entity.Infrastructure
Сборка: EntityFramework (в EntityFramework.dll)
Синтаксис
'Декларация
Public Function SingleOrDefaultAsync ( _
predicate As Func(Of TElement, Boolean), _
cancellationToken As CancellationToken _
) As Task(Of TElement)
'Применение
Dim instance As DbRawSqlQuery
Dim predicate As Func(Of TElement, Boolean)
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of TElement)
returnValue = instance.SingleOrDefaultAsync(predicate, _
cancellationToken)
public Task<TElement> SingleOrDefaultAsync(
Func<TElement, bool> predicate,
CancellationToken cancellationToken
)
public:
Task<TElement>^ SingleOrDefaultAsync(
Func<TElement, bool>^ predicate,
CancellationToken cancellationToken
)
member SingleOrDefaultAsync :
predicate:Func<'TElement, bool> *
cancellationToken:CancellationToken -> Task<'TElement>
public function SingleOrDefaultAsync(
predicate : Func<TElement, boolean>,
cancellationToken : CancellationToken
) : Task<TElement>
Параметры
- predicate
Тип: System.Func<TElement, Boolean>
Функция, предназначенная для проверки каждого элемента по условию.
- cancellationToken
Тип: System.Threading.CancellationToken
Токен CancellationToken, который нужно отслеживать во время ожидания выполнения задачи.
Возвращаемое значение
Тип: System.Threading.Tasks.Task<TElement>
Задача, представляющая асинхронную операцию.Результат задачи содержит единственный элемент в результате запроса, который удовлетворяет условию в predicate, или default ( TElement ), если таковой элемент не найден.
Исключения
Исключение | Условие |
---|---|
ArgumentNullException | Значение predicate равно null. |
InvalidOperationException | Условию в predicate удовлетворяют больше одного элемента. |
Примечания
Несколько активных операций в одном экземпляре контекста не поддерживается. Используйте «await» для обеспечения того, чтобы все асинхронные операции завершались перед вызовом другого метода применительно к этому контексту.