ValueTask Структура

Определение

public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask>

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

type ValueTask = struct

Public Structure ValueTask
Implements IEquatable(Of ValueTask)

Наследование

Object

ValueType

ValueTask

Реализации

IEquatable<ValueTask>

Комментарии

ValueTaskЭкземпляр может быть либо ожидающим, либо преобразованным в Task using AsTask .A ValueTask instance may either be awaited or converted to a Task using AsTask. ValueTaskЭкземпляр можно ожидать только один раз, и потребители могут не вызываться GetAwaiter() до завершения экземпляра.A ValueTask instance may only be awaited once, and consumers may not call GetAwaiter() until the instance has completed. Если эти ограничения неприемлемы, преобразуйте в в, ValueTask Task вызвав AsTask .If these limitations are unacceptable, convert the ValueTask to a Task by calling AsTask.

В экземпляре никогда не следует выполнять следующие операции ValueTask :The following operations should never be performed on a ValueTask instance:

• Ожидание экземпляра несколько раз.Awaiting the instance multiple times.
• Вызов AsTask несколько раз.Calling AsTask multiple times.
• Использование более чем одного из этих методов для использования экземпляра.Using more than one of these techniques to consume the instance.

Если вы выполните одно из указанных выше действий, результаты не будут определены.If you do any of the above, the results are undefined.

ValueTaskПредставляет собой структуру, которая может заключить в оболочку Task или IValueTaskSource экземпляр.A ValueTask is a structure that can wrap either a Task or a IValueTaskSource instance. Возврат объекта ValueTask , который создает оболочку IValueTaskSource экземпляра из асинхронного метода, позволяет приложениям с высокой пропускной способностью избежать выделения памяти с помощью пула многократно используемых IValueTaskSource объектов.Returning a ValueTask that wraps a IValueTaskSource instance from an asynchronous method enables high-throughput applications to avoid allocations by using a pool of reusable IValueTaskSource objects. Дополнительные сведения см. в статьях понимание причинах, что и когда имеет ValueTask.For more information, see Understanding the Whys, Whats, and Whens of ValueTask.

Использование ValueTask вместо создает Task некоторые дополнительные издержки.Using a ValueTask instead of a Task introduces some overhead. Поскольку ValueTask является структурой с несколькими полями, возвращение ее из метода приводит к копированию большего количества данных по сравнению с возвратом одной Task ссылки.Because ValueTask is a structure with multiple fields, returning it from the method results in copying more data compared to returning a single Task reference. Таким образом, по умолчанию для любого асинхронного метода, который не возвращает результат, должен возвращаться Task .As such, the default choice for any asynchronous method that does not return a result should be to return a Task. Только если анализ производительности доказывает, что следует ValueTask использовать вместо Task .Only if performance analysis proves it worthwhile should a ValueTask be used instead of a Task. Task.CompletedTaskСвойство следует использовать для обратного успешного завершения одноэлементного элемента в случае, когда метод, возвращающий Task Завершение, синхронно и успешно завершается.The Task.CompletedTask property should be used to hand back a successfully completed singleton in the case where a method returning a Task completes synchronously and successfully.

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

Свойства

Методы

Операторы

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