Język

CA1876: Nie używaj elementu „AsParallel” w pętli „foreach”

Property Value
Identyfikator reguły CA1876
Title Nie należy używać AsParallel w foreach
Category Wydajność
Poprawka łamiąca kompatybilność lub niełamiąca kompatybilności Non-breaking
Domyślnie włączone w .NET 10 No
Domyślnie włączone w .NET 11 Jako sugestia
Obsługiwane języki C# i Visual Basic

Cause

Pętla foreach iteruje po wyniku wywołania AsParallel() bezpośrednio.

Opis reguły

Instrukcja foreach przetwarza każdy element szeregowo. Wywołanie AsParallel na kolekcji nie powoduje równoległego uruchomienia pętli.

Jak naprawić naruszenia

Usuń AsParallel() , jeśli pętla powinna być uruchamiana szeregowo. Aby przetworzyć każdy element równolegle, użyj polecenia ForEach. Aby zrównać operacje zapytań LINQ, wywołaj metodę AsParallel() przed tymi operacjami, a następnie wylicz zapytanie lub wywołaj metodę ForAll.

Examples

Poniższy kod przedstawia naruszenie 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

Aby przetworzyć każdy element równolegle, użyj polecenia Parallel.ForEach. Użyj tego podejścia tylko wtedy, gdy praca może być uruchamiana współbieżnie; nie zachowuje kolejności elementów.

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

Kiedy pomijać ostrzeżenia

Pomiń ostrzeżenie tylko wtedy, gdy używasz AsParallel() z innego powodu. Sama pętla foreach nadal działa szeregowo.

Pomijanie ostrzeżenia

Aby pominąć pojedyncze naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia dotyczące analizy kodu.

Informacje dodatkowe