Langue

CA1876 : N’utilisez pas « AsParallel » dans « foreach »

Propriété Value
ID de règle CA1876
Titre Ne pas utiliser AsParallel dans foreach
Catégorie Efficacité
Le correctif a un effet disruptif ou non disruptif Non-breaking
Activé par défaut dans .NET 10 No
Activé par défaut dans .NET 11 Comme suggestion
Langues applicables C# et Visual Basic

Cause

Une boucle foreach énumère directement le résultat de l’appel AsParallel().

Description de la règle

L’instruction foreach traite chaque élément en série. L’appel à AsParallel sur la collection n’exécute pas la boucle en parallèle.

Comment corriger les violations

Supprimez AsParallel() si la boucle doit s’exécuter en série. Pour traiter chaque élément en parallèle, utilisez ForEach. Pour paralléliser les opérations de requête LINQ, appelez AsParallel() avant ces opérations, puis énumérez la requête ou l’appel ForAll.

Examples

Le code suivant montre une violation 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

Pour traiter chaque élément en parallèle, utilisez Parallel.ForEach. Utilisez cette approche uniquement lorsque le travail peut s’exécuter simultanément ; elle ne conserve pas l’ordre des éléments.

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

Quand supprimer les avertissements

Supprimez l’avertissement uniquement lorsque vous utilisez AsParallel() pour une autre raison. La boucle foreach elle-même s’exécute toujours en série.

Supprimer un avertissement

Pour masquer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver, puis réactiver la règle.

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

Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.

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

Pour plus d’informations, consultez Comment supprimer les avertissements d’analyse du code.

Voir aussi