ValueTask Structure

Définition

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)

Héritage

Object

ValueType

ValueTask

Implémente

IEquatable<ValueTask>

Remarques

Une ValueTask instance peut être attendue ou convertie en Task utilisation AsTask. Une ValueTask instance ne peut être attendue qu’une seule fois, et les consommateurs peuvent ne pas appeler GetAwaiter() tant que l’instance n’est pas terminée. Si ces limitations sont inacceptables, convertissez-les ValueTask en un Task en appelant AsTask.

Les opérations suivantes ne doivent jamais être effectuées sur une ValueTask instance :

• En attente de l’instance plusieurs fois.
• Appel AsTask plusieurs fois.
• Utilisation de plusieurs de ces techniques pour consommer l’instance.

Si vous effectuez l’une des versions ci-dessus, les résultats ne sont pas définis.

Il ValueTask s’agit d’une structure qui peut encapsuler une instance ou une TaskIValueTaskSource instance. Le renvoi d’une ValueTaskIValueTaskSource instance encapsulée à partir d’une méthode asynchrone permet aux applications à débit élevé d’éviter les allocations à l’aide d’un pool d’objets réutilisables IValueTaskSource . Pour plus d’informations, consultez Présentation des raisons, des éléments et des moments de ValueTask.

L’utilisation d’une ValueTask surcharge au lieu d’une Task surcharge est introduite. Étant donné qu’il ValueTask s’agit d’une structure avec plusieurs champs, le renvoyer à partir de la méthode entraîne la copie de données supplémentaires par rapport au retour d’une référence unique Task . Par conséquent, le choix par défaut pour toute méthode asynchrone qui ne retourne pas de résultat doit être de retourner un Task. Seulement si l’analyse des performances prouve qu’il vaut la peine d’être ValueTask utilisée au lieu d’un Task. La Task.CompletedTask propriété doit être utilisée pour remettre un singleton terminé correctement dans le cas où une méthode retournant une Task opération se termine de façon synchrone et réussie.