ValueTask 結構

定義

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)

繼承

Object

ValueType

ValueTask

實作

IEquatable<ValueTask>

備註

一個 ValueTask 實例可以被等待，也可以被轉換成 Task 使用 AsTask。 一個 ValueTask 實例只能等待一次，消費者在實例完成前不得撥打 GetAwaiter() 電話。 若這些限制無法接受，則透過呼叫 ValueTask將 Task 轉換為 。AsTask

以下操作絕不應對任何 ValueTask 實例執行：

• 多次等待實例。
• 打了好幾通電話 AsTask 。
• 使用多種技巧來消費實例。

如果你做上述任何一項，結果將無法定義。

A ValueTask 是一個結構，可以包裹 a Task 或實 IValueTaskSource 例。 從非同步方法回傳ValueTask包裹實例的 aIValueTaskSource，使高吞吐量應用程式能透過使用可IValueTaskSource重用物件池來避免配置。 欲了解更多資訊，請參閱 《理解 ValueTask 的初次、為何與何時》。

使用 a ValueTask 代替 a Task 會增加一些開銷。 由於 ValueTask 是一個包含多個欄位的結構，從方法回傳會比回傳單一 Task 參考資料多。 因此，任何不回傳結果的非同步方法的預設選擇應是回傳 Task。 只有在績效分析證明其值得時，才應使用 a ValueTask 代替 Task。 當一個返回 的方法Task.CompletedTask同步且成功完成時，應用來Task回傳成功完成的單例。