Lingua

CA1876: Non usare 'AsParallel' in 'foreach'

Property Value
ID regola CA1876
Title Non usare AsParallel in foreach
Category Prestazioni
Correzione che interrompe o non interrompe 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

Un ciclo foreach enumera il risultato della chiamata diretta a AsParallel().

Descrizione della regola

L'istruzione foreach elabora ogni elemento in modo seriale. La chiamata AsParallel alla raccolta non fa sì che il ciclo venga eseguito in parallelo.

Come correggere le violazioni

Rimuovere AsParallel() se il ciclo deve essere eseguito serialmente. Per elaborare ogni elemento in parallelo, usare ForEach. Per parallelizzare le operazioni di query LINQ, chiamare AsParallel() prima di tali operazioni, quindi enumerare la query o chiamare ForAll.

Examples

Il codice seguente mostra una violazione di CA1876:

var values = new[] { 1, 2, 3 };
foreach (var value in values.AsParallel())
    Console.WriteLine(value);
Dim values = {1, 2, 3}
For Each value In values.AsParallel()
    Console.WriteLine(value)
Next

Per elaborare ogni elemento in parallelo, usare Parallel.ForEach. Usare questo approccio solo quando il lavoro può essere eseguito contemporaneamente; non mantiene l'ordine degli elementi.

var values = new[] { 1, 2, 3 };
Parallel.ForEach(values, value => Console.WriteLine(value));
Dim values = {1, 2, 3}
Parallel.ForEach(values, Sub(value) Console.WriteLine(value))

Quando eliminare gli avvisi

Sopprimere l'avviso solo quando si usa AsParallel() per un altro motivo. Il foreach ciclo stesso viene comunque eseguito serialmente.

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 CA1876
// The code that's violating the rule is on this line.
#pragma warning restore CA1876

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.CA1876.severity = none

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

Vedere anche