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 .
• Использование нескольких из этих методов для использования экземпляра .

При любом из описанных выше действий результаты будут неопределенными.

— ValueTask это структура, которая может обертывать Task экземпляр или IValueTaskSource . Возврат объекта , ValueTask который заключает IValueTaskSource экземпляр из асинхронного метода, позволяет приложениям с высокой пропускной способностью избежать выделения, используя пул многократно используемых IValueTaskSource объектов. Дополнительные сведения см. в разделе Общие сведения о причинах, что и когда из ValueTask.

ValueTask Использование вместо вызывает некоторые Task издержки. Так как ValueTask является структурой с несколькими полями, ее возврат из метода приводит к копированию большего набора данных по сравнению с одной ссылкой Task . Таким образом, по умолчанию для любого асинхронного метода, который не возвращает результат, следует возвращать Task. Только в том случае, если анализ производительности докажет, что это целесообразно, следует ValueTask использовать вместо Task. Свойство Task.CompletedTask следует использовать для передачи успешно завершенного одноэлементного объекта в случае, когда метод, возвращающий Task , завершается синхронно и успешно.

Конструкторы

Свойства

Методы

Операторы

Применяется к