ValueTask<TResult> 结构

定义

generic <typename TResult>
public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask<TResult>>

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

type ValueTask<'Result> = struct

Public Structure ValueTask(Of TResult)
Implements IEquatable(Of ValueTask(Of TResult))

类型参数

继承

Object

ValueType

ValueTask<TResult>

实现

IEquatable<ValueTask<TResult>>

注解

ValueTask<TResult>实例可以等待或转换为 Task<TResult> using AsTask。 一个 ValueTask<TResult> 实例只能等待一次，并且使用者在实例完成之前可能不会读取 Result 。 如果这些限制是不能接受的，请通过调用AsTask将其转换为 。ValueTask<TResult>Task<TResult>

不应对 ValueTask<TResult> 实例执行以下操作：

• 等待实例多次。
• 多次调用 AsTask 。
• 使用 .Result 或 .GetAwaiter().GetResult() 操作尚未完成或多次使用。
• 使用这些技术中的多个技术来使用实例。

如果执行上述任一操作，则结果未定义。

如果方法可能同步提供其操作结果，并且预期调用频率如此频繁，则此方法可能会返回此值类型的实例，以便每次调用分配新 Task<TResult> 项的成本将令人望而却步。

使用 ValueTask<TResult> 替代 Task<TResult>方法有利弊。 例如，虽然在成功结果同步可用的情况下，一个 ValueTask<TResult> 可以帮助避免分配，但它也包含多个字段，而 Task<TResult> 作为引用类型是单个字段。 这意味着从方法返回一个 ValueTask<TResult> 会导致复制更多数据。 这也意味着，如果返回某个 ValueTask<TResult> 方法的方法在异步方法中等待，则异步方法的状态机将更大，因为它必须存储包含多个字段而不是单个引用的结构。

对于使用 await 的异步操作结果以外的用途， ValueTask<TResult> 可能会导致需要更多分配的卷积编程模型。 例如，请考虑一个方法，该方法可以返回 Task<TResult> 具有缓存任务作为常见结果或 ValueTask<TResult>. 如果结果的使用者希望将其用作 Task<TResult> 方法 WhenAll ，或者 WhenAny， ValueTask<TResult> 必须先将其转换为 Task<TResult> using AsTask，从而导致在首先使用缓存 Task<TResult> 时避免的分配。

因此，任何异步方法的默认选择应该是返回或 TaskTask<TResult>。 仅当性能分析证明值得使用时，才应 ValueTask<TResult> 使用而不是 Task<TResult>使用。 对于大多数方案，不建议使用非泛型版本 ValueTask 。 CompletedTask当方法同步且成功返回Task时，该属性应用于回退成功完成的单一实例。