ValueTask Estructura

Definición

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)

Herencia

Object

ValueType

ValueTask

Implementaciones

IEquatable<ValueTask>

Comentarios

Una ValueTask instancia se puede esperar o convertir en Task mediante AsTask .A ValueTask instance may either be awaited or converted to a Task using AsTask. Una ValueTask instancia solo se puede esperar una vez y los consumidores no pueden llamar GetAwaiter() hasta que la instancia se ha completado.A ValueTask instance may only be awaited once, and consumers may not call GetAwaiter() until the instance has completed. Si estas limitaciones son inaceptables, convierta el ValueTask en un llamando a Task AsTask .If these limitations are unacceptable, convert the ValueTask to a Task by calling AsTask.

Las siguientes operaciones no deben realizarse nunca en una ValueTask instancia de:The following operations should never be performed on a ValueTask instance:

• Esperando la instancia varias veces.Awaiting the instance multiple times.
• Llamada AsTask varias veces.Calling AsTask multiple times.
• Usar más de una de estas técnicas para consumir la instancia.Using more than one of these techniques to consume the instance.

Si realiza alguna de las anteriores, los resultados son indefinidos.If you do any of the above, the results are undefined.

Una ValueTask es una estructura que puede incluir una Task instancia de o IValueTaskSource .A ValueTask is a structure that can wrap either a Task or a IValueTaskSource instance. Devolver un ValueTask que contiene una IValueTaskSource instancia de un método asincrónico permite a las aplicaciones de alto rendimiento evitar asignaciones mediante un grupo de objetos reutilizables 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. Para obtener más información, vea Descripción de Whys, What y When of ValueTask.For more information, see Understanding the Whys, Whats, and Whens of ValueTask.

El uso ValueTask de un en lugar de un Task presenta cierta sobrecarga.Using a ValueTask instead of a Task introduces some overhead. Dado que ValueTask es una estructura con varios campos, la devolución del método provoca la copia de más datos en comparación con la devolución de una sola Task referencia.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. Como tal, la opción predeterminada para cualquier método asincrónico que no devuelve un resultado debe ser devolver Task .As such, the default choice for any asynchronous method that does not return a result should be to return a Task. Solo si el análisis de rendimiento demuestra que merece la pena ValueTask usar en lugar de un Task .Only if performance analysis proves it worthwhile should a ValueTask be used instead of a Task. La Task.CompletedTask propiedad se debe usar para revertir un singleton completado correctamente en caso de que un método que devuelva se complete de forma Task sincrónica y correcta.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.

Constructores

Propiedades

Métodos

Operadores

Se aplica a