ValueTask<TResult> Struktura

Definice

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))

Parametry typu

Dědičnost

Object

ValueType

ValueTask<TResult>

Implementuje

IEquatable<ValueTask<TResult>>

Poznámky

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

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

• Čeká na instanci několikrát.
• Volání AsTask vícekrát.
• Použití .Result nebo .GetAwaiter().GetResult() v případě, že se operace ještě nedokončila, nebo je použijte několikrá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.

Metoda může vrátit instanci tohoto typu hodnoty, pokud je pravděpodobné, že výsledek její operace bude k dispozici synchronně a když se očekává, že bude vyvolána tak často, že náklady na přidělení nového Task<TResult> pro každé volání budou zakázané.

ValueTask<TResult> Použití namísto Task<TResult>. I když ValueTask<TResult> například může pomoct vyhnout se přidělení v případě, že je úspěšný výsledek k dispozici synchronně, obsahuje také více polí, zatímco Task<TResult> jako typ odkazu je jedno pole. To znamená, že vrácení ValueTask<TResult> z metody vede ke zkopírování více dat. To také znamená, že pokud je metoda, která vrací ValueTask<TResult> hodnotu, očekávána v rámci asynchronní metody, bude stavový počítač pro danou asynchronní metodu větší, protože musí místo jediného odkazu ukládat strukturu obsahující více polí.

U jiných použití, než je využití výsledku asynchronní operace pomocí funkce await, ValueTask<TResult> může vést k více konvolutnějšímu programovacímu modelu, který vyžaduje více přidělení. Představte si například metodu, která by mohla jako běžný výsledek vrátit buď Task<TResult> úlohu s mezipamětí, nebo ValueTask<TResult>. Pokud ho příjemce výsledku chce použít jako metodu Task<TResult> , jako WhenAll je nebo WhenAny, ValueTask<TResult> musí být nejprve převedena na Task<TResult> pomocí AsTask, což vede k přidělení, kterému by se vyhýbalo, kdyby se na prvním místě použila Task<TResult> mezipaměť.

Výchozí volbou pro jakoukoli asynchronní metodu by proto mělo být vrácení nebo TaskTask<TResult>. Pouze v případě, že analýza výkonu prokáže, že je vhodné ValueTask<TResult> použít místo Task<TResult>. Pro většinu scénářů se nedoporučuje obecná verze ValueTask nástroje. Vlastnost 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