QueryableExtensions.FirstOrDefaultAsync 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
| Nome | Descrição |
|---|---|
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>) |
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>>) |
Retorna de forma assíncrona o primeiro elemento de uma sequência que satisfaz 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. |
| FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Retorna de forma assíncrona o primeiro elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>)
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);
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)
Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> elemento do qual retornar o primeiro elemento.
Retornos
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
source é
null .
source não implementa IDbAsyncQueryProvider .
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 neste contexto.
Aplica-se a
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
Retorna de forma assíncrona o primeiro elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.
[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)
Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> elemento do qual retornar o primeiro elemento.
- predicate
- Expression<Func<TSource,Boolean>>
Uma função para testar cada elemento para uma condição.
Retornos
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 no source qual passa o teste especificado por predicate.
- Atributos
Exceções
source ou
predicate é
null .
source não implementa IDbAsyncQueryProvider .
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 neste contexto.
Aplica-se a
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);
static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> elemento do qual retornar o primeiro elemento.
- cancellationToken
- CancellationToken
Um CancellationToken para observar enquanto aguarda a conclusão da tarefa.
Retornos
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
source é
null .
source não implementa IDbAsyncQueryProvider .
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 neste contexto.
Aplica-se a
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Retorna de forma assíncrona o primeiro elemento de uma sequência que satisfaz uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.
[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>
Parâmetros de tipo
- TSource
O tipo dos elementos de source.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> elemento do qual retornar o primeiro elemento.
- predicate
- Expression<Func<TSource,Boolean>>
Uma função para testar cada elemento para uma condição.
- cancellationToken
- CancellationToken
Um CancellationToken para observar enquanto aguarda a conclusão da tarefa.
Retornos
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 no source qual passa o teste especificado por predicate.
- Atributos
Exceções
source ou
predicate é
null .
source tem mais de um elemento.
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 neste contexto.