Language

CA1876: 'foreach' で 'AsParallel' を使用しないでください

プロパティ Value
ルール ID CA1876
肩書き foreach で AsParallel を使用しないでください
カテゴリ パフォーマンス
修正が破壊的変更か非破壊的変更か Non-breaking
.NET 10 で既定で有効 No
.NET 11 で既定で有効 一つの提案として
該当する言語 C# と Visual Basic

Cause

foreach ループは、AsParallel()を直接呼び出した結果を列挙します。

ルールの説明

foreachステートメントは、各項目を順次処理します。 コレクションで AsParallel を呼び出しても、ループは並列で実行されません。

違反を修正する方法

ループを順次実行する必要がある場合は、 AsParallel() を削除します。 各項目を並列処理するには、 ForEachを使用します。 LINQ クエリ操作を並列化するには、それらの操作の前に AsParallel() を呼び出し、クエリを列挙するか、 ForAllを呼び出します。

例示

次のコードは、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

各項目を並列処理するには、 Parallel.ForEachを使用します。 この方法は、作業を同時に実行できる場合にのみ使用します。アイテムの順序は保持されません。

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

どのようなときに警告を抑制するか

別の理由で AsParallel() を使用する場合にのみ、警告を抑制します。 foreach ループ自体は、引き続き順次実行されます。

警告を抑制する

1 つの違反を抑制するには、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、ルールを再度有効にします。

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

ファイル、フォルダー、またはプロジェクトのルールを無効にするには、noneでその重要度をに設定します。

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

詳細については、「 コード分析の警告を抑制する方法」を参照してください。

参照