ValueTask<TResult> Estrutura

Definição

generic <typename TResult>
public value class ValueTask : IEquatable<System::Threading::Tasks::ValueTask<TResult>>

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

type ValueTask<'Result> = struct

Public Structure ValueTask(Of TResult)
Implements IEquatable(Of ValueTask(Of TResult))

Parâmetros de tipo

Herança

Object

ValueType

ValueTask<TResult>

Implementações

IEquatable<ValueTask<TResult>>

Comentários

Uma ValueTask<TResult> instância pode ser aguardada ou convertida em um Task<TResult> uso AsTask. Uma ValueTask<TResult> instância só pode ser aguardada uma vez e os consumidores podem não ler Result até que a instância seja concluída. Se essas limitações forem inaceitáveis, converta em ValueTask<TResult> um Task<TResult> chamando AsTask.

As seguintes operações nunca devem ser executadas em uma ValueTask<TResult> instância:

• Aguardando a instância várias vezes.
• Chamando AsTask várias vezes.
• Usar .Result ou .GetAwaiter().GetResult() quando a operação ainda não tiver sido concluída ou usá-la várias vezes.
• Usando mais de uma dessas técnicas para consumir a instância.

Se você fizer qualquer uma das opções acima, os resultados serão indefinidos.

Um método pode retornar uma instância desse tipo de valor quando é provável que o resultado de sua operação esteja disponível de forma síncrona e, quando se espera que seja invocado com tanta frequência, o custo de alocar um novo Task<TResult> para cada chamada será proibitivo.

Há compensações para usar um ValueTask<TResult> em vez de um Task<TResult>. Por exemplo, enquanto um ValueTask<TResult> pode ajudar a evitar uma alocação no caso em que o resultado bem-sucedido está disponível de forma síncrona, ele também contém vários campos, enquanto um Task<TResult> tipo de referência é um único campo. Isso significa que retornar um ValueTask<TResult> de um método resulta na cópia de mais dados. Isso também significa que, se um método que retorna um ValueTask<TResult> é aguardado dentro de um método assíncrono, o computador de estado para esse método assíncrono será maior, pois ele deve armazenar um struct que contém vários campos em vez de uma única referência.

Para usos diferentes de consumir o resultado de uma operação assíncrona usando await, ValueTask<TResult> pode levar a um modelo de programação mais complicado que requer mais alocações. Por exemplo, considere um método que pode retornar um Task<TResult> com uma tarefa armazenada em cache como um resultado comum ou um ValueTask<TResult>. Se o consumidor do resultado quiser usá-lo como um Task<TResult> método como WhenAll ou WhenAny, primeiro, deve ValueTask<TResult> ser convertido em um Task<TResult> uso AsTask, levando a uma alocação que teria sido evitada se um cache Task<TResult> tivesse sido usado em primeiro lugar.

Dessa forma, a opção padrão para qualquer método assíncrono deve ser retornar um Task ou Task<TResult>. Somente se a análise de desempenho provar que vale a pena deve ValueTask<TResult> ser usada em vez de uma Task<TResult>. A versão não genérica não é recomendada para a maioria dos ValueTask cenários. A CompletedTask propriedade deve ser usada para devolver um singleton concluído com êxito no caso em que um método retornando uma Task conclusão síncrona e bem-sucedida.