Dil

CA1876: 'foreach' içinde 'AsParallel' kullanmayın

Property Değer
Kural Kimliği CA1876
Title foreach içinde AsParallel kullanmayın
Category Performans
Düzeltme bozucu veya bozucu olmayan niteliktedir Non-breaking
.NET 10'da varsayılan olarak etkin No
.NET 11'de varsayılan olarak etkindir Öneri olarak
Geçerli diller C# ve Visual Basic

Cause

Bir foreach döngüsü, AsParallel() doğrudan çağrılmasının sonucunu yineler.

Kural açıklaması

foreach deyimi her öğeyi seri olarak işler. Koleksiyon üzerinde AsParallel çağrılması, döngünün paralel olarak çalışmasını sağlamaz.

İhlalleri düzeltme

Döngünün seri olarak çalışması gerekiyorsa kaldırın AsParallel() . Her öğeyi paralel olarak işlemek için kullanın ForEach. LINQ sorgu işlemlerini paralelleştirmek için, bu işlemlerden önce AsParallel() öğesini çağırın, ardından sorguyu yineleyin veya ForAll öğesini çağırın.

Examples

Aşağıdaki kod CA1876 ihlalini gösterir:

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

Her öğeyi paralel olarak işlemek için Parallel.ForEach kullanın. Bu yaklaşımı yalnızca iş paralel olarak çalışabiliyorsa kullanın; öğe sırasını korumaz.

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))

Uyarıların ne zaman bastırılması gerekiyor?

Uyarıyı yalnızca AsParallel() öğesini başka bir nedenle kullandığınızda gizleyin. Döngünün foreach kendisi hala seri olarak çalışır.

Uyarıyı gizleme

Tek bir ihlali engellemek için önişlemci yönergelerini kaynak dosyanıza ekleyerek kuralı devre dışı bırakın ve sonra yeniden etkinleştirin.

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

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, none önem derecesini olarak ayarlayın.

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

Daha fazla bilgi için bkz. Kod analizi uyarılarını gizleme.

Ayrıca bkz.