Lenguaje
Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
| 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.