EntityFrameworkQueryableExtensions.SingleAsync Метод

Определение

Пространство имен:

Microsoft.EntityFrameworkCore

Сборка:

Microsoft.EntityFrameworkCore.dll

Пакет:

Microsoft.EntityFrameworkCore v1.0.6

Пакет:

Microsoft.EntityFrameworkCore v1.1.6

Пакет:

Microsoft.EntityFrameworkCore v2.0.3

Пакет:

Microsoft.EntityFrameworkCore v2.1.11

Пакет:

Microsoft.EntityFrameworkCore v2.2.6

Пакет:

Microsoft.EntityFrameworkCore v3.0.0

Пакет:

Microsoft.EntityFrameworkCore v3.1.0

Пакет:

Microsoft.EntityFrameworkCore v5.0.0

Пакет:

Microsoft.EntityFrameworkCore v6.0.0

Перегрузки

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 , чтобы наблюдать за ожиданием завершения задачи.

Возвращаемое значение

Task<TSource>

Задача, представляющая асинхронную операцию. Результат задачи содержит один элемент входной последовательности.

Исключения

ArgumentNullException

source имеет значение null.

InvalidOperationException

source содержит несколько элементов.

-или-

Последовательность source не содержит элементов.

OperationCanceledException

Если 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 , чтобы наблюдать за ожиданием завершения задачи.

Возвращаемое значение

Task<TSource>

Задача, представляющая асинхронную операцию. Результат задачи содержит один элемент входной последовательности, удовлетворяющей условию.predicate

Исключения

ArgumentNullException

Параметр source или predicate имеет значение null.

InvalidOperationException

Ни один элемент не удовлетворяет условию предиката predicate.

-или-

Условию предиката predicate удовлетворяет более одного элемента.

-или-

Последовательность source не содержит элементов.

OperationCanceledException

Если CancellationToken отменяется.

Комментарии

Несколько активных операций в одном экземпляре контекста не поддерживаются. Используйте await для проверки завершения любых асинхронных операций перед вызовом другого метода в этом контексте. Дополнительные сведения см. в статье об устранении проблем с потоками DbContext .

Дополнительные сведения см. в разделе "Запрос данных с помощью EF Core ".