CKTIS / C#
Task — operações assíncronas e espera por grupos de tarefas
Task representa uma operação assíncrona, enquanto Task<T> também fornece o respetivo resultado. Conheça as diferenças entre Task.Yield, Task.WaitAll, que bloqueia, e Task.WhenAll, que não bloqueia, incluindo a ordem dos resultados e o tratamento de falhas.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
await Task.Yield();
Task.WaitAll(tasks);
Task combined = Task.WhenAll(tasks);
TResult[] results = await Task.WhenAll<TResult>(resultTasks);System.Threading.Tasks.Task representa uma operação assíncrona sem valor de resultado; Task<T> fornece um resultado do tipo T. Uma tarefa não é o mesmo que uma thread. As chamadas aqui descritas estão disponíveis no .NET 10 e não requerem funcionalidades da linguagem em versão preview.
await Task.Yield() força a retoma assíncrona do resto do método. A chamada Task.Yield() devolve YieldAwaitable, não Task; a expressão completa await Task.Yield() não produz qualquer valor. A continuação é enviada para o contexto de sincronização atual se este for uma instância de um tipo derivado de SynchronizationContext. Se não existir um contexto atual ou se o seu tipo for exatamente SynchronizationContext, é utilizado o agendador de tarefas atual. Isto não garante uma mudança de thread nem uma interface de utilizador responsiva.
Task.WaitAll(tasks) bloqueia a thread que faz a chamada até todas as tarefas terminarem. As falhas ou cancelamentos das tarefas são comunicados através de AggregateException. Bloquear uma thread necessária às continuações pode causar um deadlock; em código assíncrono, prefira await Task.WhenAll(tasks). Cancelar a espera em si através de uma sobrecarga com token não cancela as tarefas.
Task.WhenAll(tasks) devolve uma tarefa combinada sem bloquear a thread que faz a chamada. Para Task<T>[], o resultado de await é um array pela ordem de entrada, não pela ordem de conclusão. Se alguma tarefa falhar, o estado é Faulted; se não houver falhas, mas existir uma tarefa cancelada, o estado é Canceled; nos restantes casos, a operação tem sucesso. Uma entrada vazia tem sucesso imediato. O exemplo apresenta os resultados apenas depois de await; Task.WaitAll é demonstrado apenas com tarefas já concluídas.
Exemplos
using System;
using System.Threading.Tasks;
internal static class Program
{
private static async Task Main()
{
Task<int>[] tasks = { DoubleAsync(3), DoubleAsync(5) };
int[] results = await Task.WhenAll(tasks);
Console.WriteLine(string.Join(", ", results));
Task[] completed = { Task.CompletedTask, Task.CompletedTask };
Task.WaitAll(completed);
Console.WriteLine("WaitAll completed");
}
private static async Task<int> DoubleAsync(int value)
{
await Task.Yield();
return value * 2;
}
}Resultado
6, 10 WaitAll completed
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.