ValueTask<TResult> Struktur

Definition

generic <typename TResult>
public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask<TResult>>

public readonly struct ValueTask<TResult> : IEquatable<System.Threading.Tasks.ValueTask<TResult>>

public struct ValueTask<TResult> : IEquatable<System.Threading.Tasks.ValueTask<TResult>>

type ValueTask<'Result> = struct

Public Structure ValueTask(Of TResult)
Implements IEquatable(Of ValueTask(Of TResult))

Typparameter

Vererbung

Object

ValueType

ValueTask<TResult>

Implementiert

IEquatable<ValueTask<TResult>>

Hinweise

Eine ValueTask<TResult> -Instanz kann entweder erwartet oder mit AsTaskin eine Task<TResult> konvertiert werden. Eine ValueTask<TResult> Instanz kann nur einmal erwartet werden, und Consumer können erst gelesen Result werden, wenn die Instanz abgeschlossen ist. Wenn diese Einschränkungen inakzeptabel sind, konvertieren Sie in ValueTask<TResult> ein, Task<TResult> indem Sie aufrufen AsTask.

Die folgenden Vorgänge sollten niemals für eine ValueTask<TResult> -Instanz ausgeführt werden:

• Mehrfaches Warten auf die Instanz.
• Mehrfaches Aufrufen AsTask .
• Verwenden Sie .Result oder .GetAwaiter().GetResult() , wenn der Vorgang noch nicht abgeschlossen wurde, oder verwenden Sie sie mehrmals.
• Verwenden sie mehr als eine dieser Techniken, um die -Instanz zu nutzen.

Wenn Sie eines der oben genannten Schritte ausführen, sind die Ergebnisse nicht definiert.

Eine Methode kann eine Instanz dieses Werttyps zurückgeben, wenn das Ergebnis ihres Vorgangs wahrscheinlich synchron verfügbar ist und wenn erwartet wird, dass sie so häufig aufgerufen wird, dass die Kosten für die Zuweisung eines neuen Task<TResult> Für jeden Aufrufs unerschwinglich sind.

Es gibt Kompromisse bei der Verwendung von anstelle ValueTask<TResult> von Task<TResult>. Ein kann beispielsweise helfen, eine Zuordnung für den Fall zu vermeiden, ValueTask<TResult> dass das erfolgreiche Ergebnis synchron verfügbar ist, enthält aber auch mehrere Felder, während ein Task<TResult> als Verweistyp ein einzelnes Feld ist. Dies bedeutet, dass das Zurückgeben von aus ValueTask<TResult> einer -Methode dazu führt, dass mehr Daten kopiert werden. Dies bedeutet auch, dass, wenn eine Methode, die zurückgibt ValueTask<TResult> , innerhalb einer asynchronen Methode erwartet wird, der Zustandscomputer für diese asynchrone Methode größer ist, da eine Struktur gespeichert werden muss, die mehrere Felder anstelle eines einzelnen Verweises enthält.

Bei anderen Verwendungen als der Verwendung des Ergebnisses eines asynchronen Vorgangs mithilfe von await kann dies zu einem komplexeren Programmiermodell führen, ValueTask<TResult> das mehr Zuordnungen erfordert. Betrachten Sie beispielsweise eine -Methode, die entweder eine Task<TResult> mit einer zwischengespeicherten Aufgabe als häufiges Ergebnis oder eine ValueTask<TResult>zurückgeben könnte. Wenn der Consumer des Ergebnisses es als in Task<TResult> einer Methode wie WhenAll oder WhenAnyverwenden möchte, muss zuerst ValueTask<TResult> in eine Task<TResult> mit AsTaskkonvertiert werden, was zu einer Zuordnung führt, die vermieden worden wäre, wenn überhaupt eine zwischengespeicherte Task<TResult> verwendet worden wäre.

Daher sollte die Standardoption für jede asynchrone Methode sein, ein Task oder Task<TResult>zurückzugeben. Nur wenn sich die Leistungsanalyse als sinnvoll erweist, sollte anstelle von verwendet ValueTask<TResult>Task<TResult>werden. Die nicht generische Version von ValueTask wird für die meisten Szenarien nicht empfohlen. Die CompletedTask -Eigenschaft sollte verwendet werden, um ein erfolgreich abgeschlossenes Singleton zurückzugeben, wenn eine Methode, die eine Task zurückgibt, synchron und erfolgreich abgeschlossen wird.

Konstruktoren

Eigenschaften

Methoden

Operatoren

Gilt für: