CA2008: Nevytvářejte úkoly bez předání taskScheduler

Článek
09/06/2023

Vlastnost	Hodnota
ID pravidla	CA2008
Název	Nevytvářejte úlohy bez předání Plánovače úloh
Kategorie	Spolehlivost
Oprava způsobující chybu nebo chybu způsobující chybu	Nenarušující
Povoleno ve výchozím nastavení v .NET 9	No

Příčina

Operace vytvoření nebo pokračování úlohy používá přetížení metody, které neurčovalo TaskScheduler parametr.

Popis pravidla

Následující metody vytvoření a pokračování úlohy .NET mají přetížení, která umožňují zadat nebo vynechat TaskScheduler instanci:

Metody System.Threading.Tasks.TaskFactory.StartNew
Metody System.Threading.Tasks.Task.ContinueWith

Vždy zadejte explicitní TaskScheduler argument, který zabrání výchozí Current hodnotě, jejíž chování je definováno volajícím a může se lišit za běhu. Current vrátí plánovač přidružený k čemukoli, co Task je aktuálně spuštěno v daném vlákně. Pokud takový úkol neexistuje, vrátí Default, který představuje fond vláken. Použití Current by mohlo vést k problémům s zablokováním nebo odezvou uživatelského rozhraní v některých situacích, kdy bylo zamýšleno vytvořit úlohu ve fondu vláken, ale místo toho čeká na návrat do vlákna uživatelského rozhraní.

Další informace a podrobné příklady naleznete v tématu New TaskCreationOptions a TaskContinuationOptions v rozhraní .NET Framework 4.5.

Poznámka:

VSTHRD105 – Vyhněte se přetížení metod, které předpokládají TaskScheduler.Current je podobné pravidlo implementované v balíčku Microsoft.VisualStudio.Threading.Analyzers .

Jak opravit porušení

Chcete-li opravit porušení, zavolejte přetížení metody, která přebírá TaskScheduler a explicitně předává Default nebo Current aby byl záměr jasný.

Kdy potlačit upozornění

Toto upozornění je určené především pro knihovny, kde se může kód spouštět v libovolných prostředích a kde by kód neměl provádět předpoklady o prostředí nebo jak volající metody může vyvolat nebo čekat na něj. Může být vhodné potlačit upozornění pro projekty, které představují kód aplikace, nikoli kód knihovny.

Potlačení upozornění

Pokud chcete pouze potlačit jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none konfiguračním souboru.

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Sdílet prostřednictvím