语言
| Property | 价值 |
|---|---|
| 规则 ID | CA1876 |
| Title | 请勿在foreach中使用AsParallel |
| 类别 | 性能 |
| 修复是中断修复还是非中断修复 | Non-breaking |
| 在 .NET 10 中默认启用 | No |
| 默认在 .NET 11 中启用 | 作为一种建议 |
| 适用的语言 | C# 和 Visual Basic |
Cause
foreach 循环枚举直接调用 AsParallel() 的结果。
规则说明
该 foreach 语句以串行方式处理每个项。 对该集合调用 AsParallel 不会使循环并行运行。
如何修复违规行为
如果循环应串行运行,请移除 AsParallel()。 若要并行处理每个项,请使用 ForEach。 若要并行化 LINQ 查询操作,请在这些操作之前调用 AsParallel() ,然后枚举查询或调用 ForAll。
Examples
以下代码显示了 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 循环本身仍可串行运行。
禁止显示警告
若要取消单个冲突,请将预处理器指令添加到源文件以禁用,然后重新启用规则。
#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
有关详细信息,请参阅 如何禁止显示代码分析警告。