Tag: async

Passe um CancellationToken de forma limpa por cada camada de uma cadeia de chamadas async no .NET 11: convenção do último parâmetro, valores padrão, tokens vinculados, RequestAborted do ASP.NET Core e o analisador CA2016 que detecta os que você esquece.

Use CancellationTokenSource.CancelAfter para aplicar um prazo em operações assíncronas no .NET 11: construtor vs CancelAfter, tokens vinculados, tratamento de exceções, Task.WaitAsync, TryReset para pooling e timeouts testáveis com TimeProvider.

Capture o que você precisa do context antes do await e proteja a retomada com if (context.mounted) return. Aqui está o padrão completo, a regra do linter que o exige e os casos extremos que ela não pega.

ValueTask e ValueTask<T> são structs que permitem que um método assíncrono retorne um resultado sem alocar um Task no heap quando ele completa de forma síncrona. O ganho é uma alocação a menos em hot paths que normalmente terminam sem aguardar. O custo é um contrato rígido de aguardar-apenas-uma-vez. Aqui está o que esse tipo realmente é, como funciona e o conjunto restrito de casos em que ele se justifica.

IAsyncEnumerable<T> é a interface para fluxos assíncronos: uma sequência cujos elementos chegam ao longo do tempo e onde cada um pode exigir um await. Veja o que ele realmente é, como await foreach e yield o impulsionam, e a regra para saber quando escolhê-lo em vez de Task<List<T>>.

Um checklist prático para reverter os tipos de retorno ValueTask e ValueTask<T> para Task e Task<T>, o que quebra nos pontos de chamada, como verificar cada mudança e como saber se a troca valeu a pena.

Sua tarefa fire-and-forget capturou um DbContext com escopo de requisição que o escopo de DI já havia liberado. Resolva um contexto novo dentro da tarefa com IServiceScopeFactory ou IDbContextFactory.

Chamar Task.Run de um controller perde trabalho ao desligar, engole exceções e captura serviços scoped já descartados. O padrão seguro é uma fila Channel limitada drenada por um BackgroundService, que abre um novo scope por item de trabalho e termina o trabalho em andamento no StopAsync.

Use Parallel.ForEach para trabalho intensivo de CPU sobre dados em memória, Parallel.ForEachAsync para E/S assíncrona sobre muitos itens com um limite de concorrência, e Task.WhenAll para um fan-out fixo e pequeno em que você quer todas as operações em andamento e precisa dos resultados.

ConfigureAwait(false) continua obrigatório em código de biblioteca que pode rodar sob um SynchronizationContext (WinForms, WPF, MAUI). Em código de aplicação no ASP.NET Core, um console app ou um worker service rodando em .NET 11, ele não faz nada.