Compartilhar via


EntityFrameworkQueryableExtensions.SingleAsync Método

Definição

Sobrecargas

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retorna de forma assíncrona o único elemento de uma sequência e gera uma exceção se não houver exatamente um elemento na sequência.

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retorna de forma assíncrona o único elemento de uma sequência que atende a uma condição especificada e gera uma exceção se houver mais de um desses elementos.

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs

Retorna de forma assíncrona o único elemento de uma sequência e gera uma exceção se não houver exatamente um elemento na sequência.

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)

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IQueryable<TSource>

Um IQueryable<T> do qual o único elemento será retornado.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<TSource>

Uma tarefa que representa a operação assíncrona. O resultado da tarefa contém o único elemento da sequência de entrada.

Exceções

source é null.

source contém mais de um elemento.

-ou-

source não contém elementos.

Se o padrão CancellationToken for cancelado.

Comentários

Não há suporte para várias operações ativas na mesma instância de contexto. Use await para garantir que todas as operações assíncronas tenham sido concluídas antes de chamar outro método nesse contexto. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

Consulte Consultar dados com o EF Core para obter mais informações e exemplos.

Aplica-se a

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs
Origem:
EntityFrameworkQueryableExtensions.cs

Retorna de forma assíncrona o único elemento de uma sequência que atende a uma condição especificada e gera uma exceção se houver mais de um desses elementos.

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)

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IQueryable<TSource>

Um IQueryable<T> do qual o único elemento será retornado.

predicate
Expression<Func<TSource,Boolean>>

Uma função para testar um elemento em relação a uma condição.

cancellationToken
CancellationToken

Um CancellationToken a ser observado enquanto aguarda a conclusão da tarefa.

Retornos

Task<TSource>

Uma tarefa que representa a operação assíncrona. O resultado da tarefa contém o único elemento da sequência de entrada que satisfaz a condição em predicate.

Exceções

source ou predicate é null.

Nenhum elemento satisfaz a condição na predicate.

- ou -

Mais de um elemento satisfaz a condição na predicate.

- ou -

source não contém elementos.

Se o padrão CancellationToken for cancelado.

Comentários

Não há suporte para várias operações ativas na mesma instância de contexto. Use await para garantir que todas as operações assíncronas tenham sido concluídas antes de chamar outro método nesse contexto. Consulte Evitando problemas de threading DbContext para obter mais informações e exemplos.

Consulte Consultar dados com o EF Core para obter mais informações e exemplos.

Aplica-se a