Langue
Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
| 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.