ValueTask<TResult> Structure

Définition

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

Paramètres de type

Héritage

Object

ValueType

ValueTask<TResult>

Implémente

IEquatable<ValueTask<TResult>>

Remarques

Une ValueTask<TResult> instance peut être attendue ou convertie en un à l’aide AsTaskTask<TResult> de . Une ValueTask<TResult> instance ne peut être attendue qu’une seule fois, et les consommateurs peuvent ne pas lire Result tant que l’instance n’est pas terminée. Si ces limitations sont inacceptables, convertissez le ValueTask<TResult> en un Task<TResult> en appelant AsTask.

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

• En attendant l’instance plusieurs fois.
• Appel plusieurs AsTask fois.
• Utilisation .Result ou .GetAwaiter().GetResult() lorsque l’opération n’est pas encore terminée, ou utilisation de ces dernières plusieurs fois.
• Utilisation de plusieurs de ces techniques pour consommer l’instance.

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

Une méthode peut retourner une instance de ce type de valeur lorsqu’il est probable que le résultat de son opération sera disponible de manière synchrone et qu’elle est censée être appelée si fréquemment que le coût d’allocation d’un nouveau Task<TResult> pour chaque appel sera prohibitif.

Il existe des compromis à l’utilisation d’un ValueTask<TResult> au lieu d’un Task<TResult>. Par exemple, si un ValueTask<TResult> peut aider à éviter une allocation dans le cas où le résultat réussi est disponible de manière synchrone, il contient également plusieurs champs, tandis qu’un Task<TResult> en tant que type de référence est un seul champ. Cela signifie que le renvoi d’un ValueTask<TResult> à partir d’une méthode entraîne la copie de données supplémentaires. Cela signifie également que si une méthode qui retourne un ValueTask<TResult> est attendue dans une méthode asynchrone, la machine d’état de cette méthode asynchrone sera plus grande, car elle doit stocker un struct contenant plusieurs champs au lieu d’une seule référence.

Pour des utilisations autres que la consommation du résultat d’une opération asynchrone à l’aide d’await, ValueTask<TResult> peut conduire à un modèle de programmation plus alambiqué qui nécessite plus d’allocations. Par exemple, considérez une méthode qui pourrait retourner un Task<TResult> avec une tâche mise en cache comme résultat commun ou un ValueTask<TResult>. Si le consommateur du résultat souhaite l’utiliser en tant que Task<TResult> dans une méthode telle que WhenAll ou WhenAny, ValueTask<TResult> le doit d’abord être converti en un Task<TResult> à l’aide AsTaskde , ce qui aboutit à une allocation qui aurait été évitée si un mis en cache Task<TResult> avait été utilisé en premier lieu.

Par conséquent, le choix par défaut pour toute méthode asynchrone doit être de retourner un Task ou .Task<TResult> Ce n’est que si l’analyse des performances s’avère utile qu’un ValueTask<TResult> doit être utilisé au lieu d’un Task<TResult>. La version non générique de n’est ValueTask pas recommandée dans la plupart des scénarios. La CompletedTask propriété doit être utilisée pour remettre un singleton correctement terminé dans le cas où une méthode renvoyant un Task se termine de manière synchrone et réussie.

Constructeurs

Propriétés

Méthodes

Opérateurs

S’applique à