ValueTask<TResult> Struct

Definizione

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

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

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

type ValueTask<'Result> = struct

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

Parametri di tipo

Ereditarietà

Object

ValueType

ValueTask<TResult>

Implementazioni

IEquatable<ValueTask<TResult>>

Commenti

Un'istanza ValueTask<TResult> di può essere attesa o convertita in un Task<TResult> oggetto utilizzando AsTask. Un'istanza ValueTask<TResult> può essere attesa una sola volta e i consumer potrebbero non leggere Result finché l'istanza non è stata completata. Se queste limitazioni non sono accettabili, convertire in ValueTask<TResult> un oggetto Task<TResult> chiamando AsTask.

Le operazioni seguenti non devono mai essere eseguite su un'istanza ValueTask<TResult> di :

• In attesa dell'istanza più volte.
• Chiamata AsTask più volte.
• Uso .Result di o .GetAwaiter().GetResult() quando l'operazione non è ancora stata completata o usarla più volte.
• Utilizzo di più di una di queste tecniche per utilizzare l'istanza di .

Se si esegue una delle operazioni precedenti, i risultati non sono definiti.

Un metodo può restituire un'istanza di questo tipo di valore quando è probabile che il risultato dell'operazione sia disponibile in modo sincrono e quando è previsto che venga richiamato così frequentemente il costo dell'allocazione di un nuovo Task<TResult> per ogni chiamata sarà proibitivo.

Esistono compromessi per l'uso di un ValueTask<TResult> oggetto anziché di un oggetto Task<TResult>. Ad esempio, mentre un ValueTask<TResult> oggetto può aiutare a evitare un'allocazione nel caso in cui il risultato riuscito sia disponibile in modo sincrono, contiene anche più campi, mentre un Task<TResult> come tipo di riferimento è un singolo campo. Ciò significa che la restituzione di un ValueTask<TResult> oggetto da un metodo comporta la copia di più dati. Significa anche che se un metodo che restituisce un ValueTask<TResult> oggetto è atteso all'interno di un metodo asincrono, la macchina a stati per tale metodo asincrono sarà più grande, perché deve archiviare uno struct contenente più campi anziché un singolo riferimento.

Per gli usi diversi dall'utilizzo del risultato di un'operazione asincrona tramite await, ValueTask<TResult> può comportare un modello di programmazione più convoluibile che richiede più allocazioni. Si consideri ad esempio un metodo che può restituire un Task<TResult> oggetto con un'attività memorizzata nella cache come risultato comune o .ValueTask<TResult> Se il consumer del risultato vuole usarlo come Task<TResult> in un metodo come WhenAll o WhenAny, deve ValueTask<TResult> prima essere convertito in un Task<TResult> oggetto utilizzando AsTask, causando un'allocazione che sarebbe stata evitata se fosse stato usato un oggetto memorizzato Task<TResult> nella cache.

Di conseguenza, la scelta predefinita per qualsiasi metodo asincrono deve essere quella di restituire un Task oggetto o Task<TResult>. Solo se l'analisi delle prestazioni dimostra che è utile ValueTask<TResult> usare anziché .Task<TResult> La versione non generica di ValueTask non è consigliata per la maggior parte degli scenari. La CompletedTask proprietà deve essere utilizzata per eseguire il rollback di un singleton completato correttamente nel caso in cui un metodo restituisca un Task oggetto completato in modo sincrono e corretto.

Costruttori

Proprietà

Metodi

Operatori

Si applica a