await (C#-Referenz)

Der await-Operator wird mit einer Aufgabe in einer asynchronen Methode, die Ausführung der - Methode aufzunehmen angewendet, bis die erwartete Aufgabe ausführt. Die Aufgabe repräsentiert die derzeit ausgeführte Arbeit.

Die asynchrone Methode, in der await verwendet wird, muss vom asynchron-Schlüsselwort geändert werden. Eine solche Methode, definiert, indem der async-Modifizierer verwendet, und gewöhnlich eine oder mehrere await Ausdrücke enthält, wird als eine asynchrone Methode.

Hinweis
Die async und await Schlüsselwörter wurden in Visual Studio 2012 eingeführt. Weitere Informationen zu neuen Funktionen in dieser Version, finden Sie unter Neues in Visual Studio 2012. Eine Einführung in die asynchrone Programmierung, finden Sie unter Asynchrone Programmierung mit Async und Await (C# und Visual Basic).

Die Aufgabe, zu der der await-Operator in der Regel angewendet wird, ist der Rückgabewert in einem Aufruf einer Methode, die implementiert Aufgabenbasiertes asynchrone Muster. Beispielseinschließungswerte des Typs Task oder Task<TResult>.

Im folgenden Code werden die HttpClient-Methode GetByteArrayAsyncTask<byte[]>, getContentsTask zurück. Die Aufgabe ist eine Zusicherung, das tatsächliche Bytearray zu erzeugen, wenn die Aufgabe abgeschlossen wurde. Der await-Operator wird auf getContentsTask angewendet, um die Ausführung in SumPageSizesAsync angehalten, bis getContentsTask abgeschlossen ist. Mittlerweile wird Steuerelement zum Aufrufer von SumPageSizesAsync zurückgegeben. Wenn getContentsTask beendet ist, wertet der await Ausdruck in ein Bytearray aus.

private async Task SumPageSizesAsync()
{
    // To use the HttpClient type in desktop apps, you must include a using directive and add a 
    // reference for the System.Net.Http namespace.
    HttpClient client = new HttpClient();
    // . . .
    Task<byte[]> getContentsTask = client.GetByteArrayAsync(url);
    byte[] urlContents = await getContentsTask;

    // Equivalently, now that you see how it works, you can write the same thing in a single line.
    //byte[] urlContents = await client.GetByteArrayAsync(url);
    // . . .
}

Wichtig
Das vollständige Beispiel finden Sie unter Exemplarische Vorgehensweise: Zugreifen auf das Web mit Async und Await (C# und Visual Basic). Sie können das Beispiel Entwickler-Codebeispiele auf der Microsoft-Website herunterladen. Das Beispiel ist im AsyncWalkthrough_HttpClient-Projekt.

Wie im vorherigen Beispiel wenn await zum Ergebnis eines Methodenaufrufs angewendet wird, der Task<TResult> zurückgibt, ist der Typ des await Ausdrucks TResult. Wenn await zum Ergebnis eines Methodenaufrufs angewendet wird, der Task zurückgibt, ist der Typ des await Ausdrucks void. Das folgende Beispiel veranschaulicht den Unterschied.

// Keyword await used with a method that returns a Task<TResult>.
TResult result = await AsyncMethodThatReturnsTaskTResult();

// Keyword await used with a method that returns a Task.
await AsyncMethodThatReturnsTask();

Ein await Ausdruck blockiert nicht den Thread, in dem er ausgeführt wird. Stattdessen wird er den Compiler, den Rest der asynchronen Methode Anmeldung wie eine Fortsetzung auf der erwarteten Aufgabe. Steuerelement kehrt dann an den Aufrufer der asynchronen Methode zurück. Wenn die Aufgabe abgeschlossen hat, ruft sie die Fortsetzung und Ausführung der asynchronen Methodenzusammenfassungen, in denen sie weg abgebrochen wurde.

Ein await Ausdruck kann nur im Text einer sofort einschließenden Methode, eines Lambda-Ausdrucks oder einer anonymen Methode auftreten, die durch einen async-Modifizierer gekennzeichnet ist. Der Begriff erwarten dient als Schlüsselwort nur in diesem Kontext. Anderswo wird er als Bezeichner interpretiert. In der - Methode, des Lambda-Ausdrucks oder der anonymen Methode kann ein await Ausdruck nicht im Text einer synchronen Funktion, in einem Abfrageausdruck, im catch oder finally-Block von Ausnahmebehandlungsanweisung, im - Block von lock-Anweisung oder in einem unsicher Kontext auftreten.