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