ValueTask Struct

Definizione

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)

Ereditarietà

Object

ValueType

ValueTask

Implementazioni

IEquatable<ValueTask>

Commenti

Un'istanza ValueTask di può essere attesa o convertita in un Task oggetto utilizzando AsTask. Un'istanza ValueTask può essere attesa una sola volta e i consumer potrebbero non chiamare GetAwaiter() fino al completamento dell'istanza. Se queste limitazioni non sono accettabili, convertire in un oggetto ValueTaskTask chiamando AsTask.

Le operazioni seguenti non devono mai essere eseguite su un'istanza ValueTask di :

• Attesa dell'istanza più volte.
• Chiamata AsTask più volte.
• Uso di più di una di queste tecniche per utilizzare l'istanza.

Se si esegue una delle operazioni precedenti, i risultati non sono definiti.

È ValueTask una struttura che può eseguire il wrapping di un oggetto Task o di un'istanza IValueTaskSource di . La restituzione di un oggetto ValueTask che esegue il wrapping di un'istanza IValueTaskSource da un metodo asincrono consente alle applicazioni a velocità effettiva elevata di evitare allocazioni usando un pool di oggetti riutilizzabili IValueTaskSource . Per altre informazioni, vedi Understanding the Whys, Whats, and when's of ValueTask.For more information, see Understanding the Whys, Whats, and when's of ValueTask.

L'uso di un ValueTask anziché di un Task comporta un sovraccarico. Poiché ValueTask è una struttura con più campi, la restituzione dal metodo comporta la copia di più dati rispetto alla restituzione di un singolo Task riferimento. Di conseguenza, la scelta predefinita per qualsiasi metodo asincrono che non restituisce un risultato deve essere la restituzione di un oggetto Task. Solo se l'analisi delle prestazioni dimostra che è utile usare anziché ValueTask .Task La Task.CompletedTask proprietà deve essere utilizzata per eseguire il handback di un singleton completato correttamente nel caso in cui un metodo restituisca un Task oggetto completato in modo sincrono e corretto.