Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Task — asynchronní operace a čekání na skupiny úloh

Task představuje asynchronní operaci, zatímco Task<T> poskytuje také její výsledek. Seznamte se s rozdíly mezi Task.Yield, blokujícím Task.WaitAll a neblokujícím Task.WhenAll, včetně pořadí výsledků a zpracování chyb.

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

Syntaxe

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

System.Threading.Tasks.Task představuje asynchronní operaci bez výsledné hodnoty; Task<T> poskytuje výsledek typu T. Úloha není totéž co vlákno. Zde popsaná volání jsou dostupná v .NET 10 a nevyžadují jazykové funkce ve verzi preview.

await Task.Yield() vynutí asynchronní pokračování zbývající části metody. Samotné volání Task.Yield() vrací YieldAwaitable, nikoli Task; celý výraz await Task.Yield() neposkytuje žádnou hodnotu. Pokračování se předá aktuálnímu synchronizačnímu kontextu, pokud je instancí typu odvozeného od SynchronizationContext. Pokud aktuální kontext neexistuje nebo je jeho typ přesně SynchronizationContext, použije se místo něj aktuální plánovač úloh. To nezaručuje změnu vlákna ani odezvu uživatelského rozhraní.

Task.WaitAll(tasks) blokuje volající vlákno, dokud nejsou dokončeny všechny úlohy. Chyby nebo zrušení úloh hlásí prostřednictvím AggregateException. Blokování vlákna, které potřebují pokračování, může způsobit uváznutí; v asynchronním kódu upřednostněte await Task.WhenAll(tasks). Zrušení samotného čekání pomocí přetížení s tokenem nezruší úlohy.

Task.WhenAll(tasks) vrací kombinovanou úlohu, aniž by blokovalo volající vlákno. Pro Task<T>[] je výsledkem await pole v pořadí vstupu, nikoli v pořadí dokončení. Selhání libovolné úlohy znamená stav Faulted; pokud nedojde k žádnému selhání, ale některá úloha je zrušena, stav je Canceled; jinak operace uspěje. Prázdný vstup uspěje okamžitě. Příklad vypíše výsledky až po await; Task.WaitAll ukazuje pouze na již dokončených úlohách.

Příklady

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

Výsledek

6, 10
WaitAll completed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje