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 Использование вместо тогоTask, чтобы привести к некоторым издержкам. Так как ValueTask это структура с несколькими полями, возвращающая его из метода, приводит к копированию дополнительных данных по сравнению с возвратом одной Task ссылки. Таким образом, выбор по умолчанию для любого асинхронного метода, который не возвращает результат, должен быть возвращен Task. Только если анализ производительности докажет, что он стоит ValueTask использовать вместо .Task Свойство Task.CompletedTask должно использоваться для передачи успешно завершенного одноэлемента в случае, когда метод, возвращающий Task завершение синхронно и успешно.