Consultas assíncronasAsynchronous Queries

As consultas assíncronas evitam o bloqueio de um thread enquanto a consulta é executada no banco de dados.Asynchronous queries avoid blocking a thread while the query is executed in the database. Isso pode ser útil para evitar o congelamento da interface do usuário de um aplicativo de cliente espesso.This can be useful to avoid freezing the UI of a thick-client application. As operações assíncronas também pode aumentar a taxa de transferência em um aplicativo Web, em que o thread pode ser liberado para atender a outras solicitações enquanto a operação do banco de dados é concluída.Asynchronous operations can also increase throughput in a web application, where the thread can be freed up to service other requests while the database operation completes. Para saber mais, veja Programação assíncrona em C#.For more information, see Asynchronous Programming in C#.

Aviso

O EF Core não oferece suporte para várias operações simultâneas sendo executadas na mesma instância de contexto.EF Core does not support multiple parallel operations being run on the same context instance. Aguarde sempre a conclusão de uma operação antes de iniciar a operação seguinte.You should always wait for an operation to complete before beginning the next operation. Isso geralmente é feito usando a palavra-chave await em cada operação assíncrona.This is typically done by using the await keyword on each asynchronous operation.

O Entity Framework Core fornece um conjunto de métodos de extensão assíncrona que podem ser usados como uma alternativa para os métodos LINQ que fazem com que uma consulta seja executada e os resultados retornados.Entity Framework Core provides a set of asynchronous extension methods that can be used as an alternative to the LINQ methods that cause a query to be executed and results returned. Os exemplo incluem ToListAsync(), ToArrayAsync(), SingleAsync() etc. Não há versões assíncronas dos operadores LINQ, como Where(...), OrderBy(...) etc. porque esses métodos só são desenvolvidos na árvore de expressão do LINQ e não fazem com que a consulta seja executada no banco de dados.Examples include ToListAsync(), ToArrayAsync(), SingleAsync(), etc. There are not async versions of LINQ operators such as Where(...), OrderBy(...), etc. because these methods only build up the LINQ expression tree and do not cause the query to be executed in the database.

Importante

Os métodos de extensão assíncrona do EF Core são definidos no namespace Microsoft.EntityFrameworkCore.The EF Core async extension methods are defined in the Microsoft.EntityFrameworkCore namespace. Esse namespace deve ser importado para que os métodos sejam disponibilizados.This namespace must be imported for the methods to be available.

public async Task<List<Blog>> GetBlogsAsync()
{
    using (var context = new BloggingContext())
    {
        return await context.Blogs.ToListAsync();
    }
}