WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Task — asynchrone Vorgänge und das Warten auf Gruppen von Tasks

Task steht für einen asynchronen Vorgang; Task<T> stellt zusätzlich dessen Ergebnis bereit. Erfahre, worin sich Task.Yield, das blockierende Task.WaitAll und das nicht blockierende Task.WhenAll unterscheiden, einschließlich Ergebnisreihenfolge und Fehlerbehandlung.

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

Syntax

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

System.Threading.Tasks.Task steht für einen asynchronen Vorgang ohne Ergebniswert; Task<T> stellt ein Ergebnis vom Typ T bereit. Ein Task ist nicht dasselbe wie ein Thread. Die hier beschriebenen Aufrufe sind in .NET 10 verfügbar und erfordern keine Preview-Sprachfunktionen.

await Task.Yield() erzwingt, dass der restliche Teil der Methode asynchron fortgesetzt wird. Der Aufruf Task.Yield() gibt YieldAwaitable zurück, nicht Task; der gesamte Ausdruck await Task.Yield() liefert keinen Wert. Die Fortsetzung wird an den aktuellen Synchronisierungskontext übergeben, wenn dieser eine Instanz eines von SynchronizationContext abgeleiteten Typs ist. Gibt es keinen aktuellen Kontext oder ist sein Typ genau SynchronizationContext, wird stattdessen der aktuelle Task-Scheduler verwendet. Weder ein Threadwechsel noch eine reaktionsfähige Benutzeroberfläche werden garantiert.

Task.WaitAll(tasks) blockiert den aufrufenden Thread, bis alle Tasks abgeschlossen sind. Fehler oder Abbruch von Tasks werden als AggregateException gemeldet. Wird ein Thread blockiert, den Fortsetzungen benötigen, kann das zu einem Deadlock führen; verwende in asynchronem Code vorzugsweise await Task.WhenAll(tasks). Das Abbrechen des Wartens über eine Überladung mit Token bricht die Tasks nicht ab.

Task.WhenAll(tasks) gibt einen kombinierten Task zurück, ohne den aufrufenden Thread zu blockieren. Bei Task<T>[] ist das Ergebnis von await ein Array in der Eingabereihenfolge, nicht in der Abschlussreihenfolge. Schlägt ein Task fehl, ist der Status Faulted; gibt es keine Fehler, aber mindestens einen Abbruch, ist der Status Canceled; andernfalls ist der Vorgang erfolgreich. Eine leere Eingabe ist sofort erfolgreich. Das Beispiel gibt die Ergebnisse erst nach await aus; Task.WaitAll wird nur mit bereits abgeschlossenen Tasks gezeigt.

Beispiele

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

Ergebnis

6, 10
WaitAll completed

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen