EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Retorna de forma assíncrona o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Retorna de forma assíncrona o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se esse elemento não existir; esse método gerará uma exceção se mais de um elemento atender à condição. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Retorna de forma assíncrona o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(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
Uma tarefa que representa a operação assíncrona.
O resultado da tarefa contém o único elemento da sequência de entrada ou default ( TSource) se a sequência não contiver elementos.
Exceções
source é null.
source contém mais de um elemento.
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 de DbContext para obter mais informações e exemplos.
Consulte Consultando dados com o EF Core para obter mais informações e exemplos.
Aplica-se a
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Retorna de forma assíncrona o único elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se esse elemento não existir; esse método gerará uma exceção se mais de um elemento atender à condição.
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 = default);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 = default);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(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
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 predicateou default ( TSource ) se nenhum elemento desse tipo for encontrado.
Exceções
source ou predicate é null.
Mais de um elemento satisfaz a condição na predicate.
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 de DbContext para obter mais informações e exemplos.
Consulte Consultando dados com o EF Core para obter mais informações e exemplos.
Aplica-se a
Entity Framework