Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes