EntityFrameworkQueryableExtensions.FirstOrDefaultAsync Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

Sobrecargas

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Retorna de forma assíncrona o primeiro elemento de uma sequência ou um valor padrão se a sequência não contiver elementos.
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Retorna de forma assíncrona o primeiro elemento de uma sequência que atende a uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.

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

Retorna de forma assíncrona o primeiro elemento de uma sequência ou um valor padrão se a sequência não contiver elementos.

public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(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> para retornar o primeiro elemento de.

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 default ( TSource ) se source estiver vazio; caso contrário, o primeiro elemento em source.

Exceções

ArgumentNullException

source é null.

OperationCanceledException

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.

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

Retorna de forma assíncrona o primeiro elemento de uma sequência que atende a uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.

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 = default);

static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function FirstOrDefaultAsync(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> para retornar o primeiro elemento de.

predicate

Expression<Func<TSource,Boolean>>

Uma função para testar cada 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 default ( TSource ) se source estiver vazio ou se nenhum elemento passar no teste especificado por predicate, caso contrário, o primeiro elemento em source que passa no teste especificado por predicate.

Exceções

ArgumentNullException

source ou predicate é null.

OperationCanceledException

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.