Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Task — operacje asynchroniczne i oczekiwanie na grupę zadań

Task reprezentuje operację asynchroniczną, a Task<T> także jej wynik. Poznaj różnice między Task.Yield, blokującym Task.WaitAll i nieblokującym Task.WhenAll oraz zasady kolejności wyników i obsługi niepowodzeń.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

await Task.Yield();
Task.WaitAll(tasks);
Task combined = Task.WhenAll(tasks);
TResult[] results = await Task.WhenAll<TResult>(resultTasks);

System.Threading.Tasks.Task reprezentuje operację asynchroniczną bez wartości wyniku; Task<T> udostępnia wynik typu T. Zadanie nie jest tym samym co wątek. Opisane wywołania są dostępne w .NET 10 i nie wymagają funkcji języka w wersji preview.

await Task.Yield() wymusza asynchroniczne wznowienie dalszej części metody. Samo wywołanie Task.Yield() zwraca YieldAwaitable, nie Task, a całe wyrażenie await Task.Yield() nie daje żadnej wartości. Kontynuacja jest przekazywana do bieżącego kontekstu synchronizacji, jeśli jest on instancją typu pochodnego od SynchronizationContext. Jeśli nie ma bieżącego kontekstu lub ma on dokładnie typ SynchronizationContext, używany jest bieżący harmonogram zadań. Nie ma gwarancji zmiany wątku ani responsywności interfejsu użytkownika.

Task.WaitAll(tasks) blokuje wywołujący wątek do zakończenia wszystkich zadań. Błędy lub anulowanie zadań zgłasza przez AggregateException. Blokowanie wątku potrzebnego kontynuacjom może prowadzić do zakleszczenia; w kodzie asynchronicznym preferuj await Task.WhenAll(tasks). Anulowanie samego oczekiwania przez przeciążenie z tokenem nie anuluje zadań.

Task.WhenAll(tasks) zwraca zadanie zbiorcze bez blokowania wywołującego wątku. Dla Task<T>[] wynik await to tablica w kolejności wejściowej, nie kolejności ukończenia. Błąd dowolnego zadania oznacza stan Faulted; bez błędów, ale z anulowaniem — Canceled; w pozostałych przypadkach — sukces. Puste wejście daje natychmiastowy sukces. Przykład wypisuje wyniki dopiero po await; Task.WaitAll pokazano wyłącznie na już zakończonych zadaniach.

Przykłady

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;
    }
}

Wynik

6, 10
WaitAll completed

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła