Lenguaje

CA1876: No usar 'AsParallel' en 'foreach'

Property Value
ID de regla CA1876
Title No usar AsParallel en foreach
Categoría Rendimiento
La corrección introduce cambios importantes o no importantes Non-breaking
Habilitado de forma predeterminada en .NET 10 No
Habilitado de forma predeterminada en .NET 11 Como sugerencia
Idiomas aplicables C# y Visual Basic

Cause

Un foreach bucle enumera el resultado de llamar AsParallel() directamente.

Descripción de la regla

La foreach instrucción procesa cada elemento en serie. Llamar a AsParallel en la colección no hace que el bucle se ejecute en paralelo.

Cómo corregir infracciones

Quite AsParallel() si el bucle se debe ejecutar en serie. Para procesar cada elemento en paralelo, use ForEach. Para paralelizar las operaciones de consulta LINQ, llame AsParallel() a antes de esas operaciones y, a continuación, enumere la consulta o llame a ForAll.

Examples

El código siguiente muestra una infracción de 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

Para procesar cada elemento en paralelo, use Parallel.ForEach. Use este enfoque solo cuando el trabajo se pueda ejecutar simultáneamente; no conserva el orden de los elementos.

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

Cuándo suprimir las advertencias

Suprima la advertencia solo cuando se use AsParallel() por otro motivo. El foreach propio bucle todavía se ejecuta en serie.

Supresión de una advertencia

Para suprimir una sola infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y, a continuación, volver a habilitar la regla.

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

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad a none en el archivo de configuración.

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

Para obtener más información, consulte Cómo suprimir advertencias de análisis de código.

Consulte también