语言

CA1876:请勿在“foreach”中使用“AsParallel”

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

有关详细信息,请参阅 如何禁止显示代码分析警告。

另请参阅