Language
| プロパティ | 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
詳細については、「 コード分析の警告を抑制する方法」を参照してください。
参照
.NET