ValueTask Struktura

Definice

public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask>

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

type ValueTask = struct

Public Structure ValueTask
Implements IEquatable(Of ValueTask)

Dědičnost

Object

ValueType

ValueTask

Implementuje

IEquatable<ValueTask>

Poznámky

Instance ValueTask může být buď očekávána, nebo převedena na Task pomocí AsTask. Instance ValueTask může být očekávána pouze jednou a příjemci nesmí volat GetAwaiter() , dokud se instance nedokončí. Pokud jsou tato omezení nepřijatelná, převeďte ValueTask na a Task voláním AsTask.

V instanci by se nikdy neměly provádět ValueTask následující operace:

• Čeká na instanci několikrát.
• Volání AsTask vícekrát.
• Použití více než jedné z těchto technik ke zpracování instance.

Pokud uděláte některou z výše uvedených možností, nebudou výsledky definovány.

A ValueTask je struktura, která může zabalit instanci Task nebo IValueTaskSource instanci. Vrácení objektu ValueTaskIValueTaskSource , který zabalí instanci z asynchronní metody, umožní aplikacím s vysokou propustností vyhnout se přidělení pomocí fondu opakovaně použitelných IValueTaskSource objektů. Další informace najdete v tématu Vysvětlení důvodů, co a kdy je hodnoty ValueTask.

Použití namísto Task a ValueTask představuje určitou režii. Vzhledem k tomu ValueTask , že se jedná o strukturu s více poli, má vrácení z metody za následek zkopírování více dat v porovnání s vrácením jednoho Task odkazu. Výchozí volbou pro jakoukoli asynchronní metodu, která nevrací výsledek, by proto měla být vrácení Task. Pouze v případě, že analýza výkonu prokáže, že je vhodné ValueTask použít místo Task. Vlastnost Task.CompletedTask by měla být použita k předání úspěšně dokončené singleton v případě, že metoda vracející Task dokončení synchronně a úspěšně.

Konstruktory

Vlastnosti

Metody

Operátory

Platí pro