Lingua

CA2027: Annulla Task.Delay dopo il completamento di Task.WhenAny

Property Value
ID regola CA2027
Title Annulla Task.Delay dopo che Task.WhenAny è stato completato
Category Affidabilità
Correzione che causa un'interruzione o no Non-breaking
Abilitato per impostazione predefinita in .NET 10 No
Abilitato per impostazione predefinita in .NET 11 Come suggerimento
Lingue applicabili C# e Visual Basic

Cause

Una chiamata a WhenAny include una Delay chiamata che non accetta un oggetto CancellationToken.

Descrizione della regola

Quando un'altra attività termina per prima, un ritardo non annullabile continua a essere eseguito fino alla scadenza del timeout. Il timer inutilizzato utilizza le risorse.

Come correggere le violazioni

Se è sufficiente attendere un'operazione con un timeout, usare Task.WaitAsync(TimeSpan). Genera un'eccezione TimeoutException se l'operazione non viene completata prima del timeout.

Se è necessario chiamare Task.WhenAny, passare un token di annullamento a Task.Delay e annullare l'origine del token al termine dell'altra attività.

Examples

Il codice seguente mostra una violazione di CA2027:

Task winner = await Task.WhenAny(operation, Task.Delay(timeout));
Dim winner = Await Task.WhenAny(operation, Task.Delay(timeout))

Usare Task.WaitAsync quando ti serve solo un timeout:

await operation.WaitAsync(timeout);
Await operation.WaitAsync(timeout)

Oppure annullare il ritardo dopo che Task.WhenAny restituisce:

using var cts = new CancellationTokenSource();
Task winner = await Task.WhenAny(operation, Task.Delay(timeout, cts.Token));
cts.Cancel();
Using cts As New CancellationTokenSource()
    Dim winner = Await Task.WhenAny(operation, Task.Delay(timeout, cts.Token))
    cts.Cancel()
End Using

Quando eliminare gli avvisi

Sopprimere l'avviso solo quando il ritardo deve continuare dopo il completamento di un'altra attività.

Eliminare un avviso

Per eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

#pragma warning disable CA2027
// The code that's violating the rule is on this line.
#pragma warning restore CA2027

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità su none nel file di configurazione .

[*.{cs,vb}]
dotnet_diagnostic.CA2027.severity = none

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.

Vedere anche