CA2247: Argument předaný Konstruktor TaskCompletionSource by měl být TaskCreationOptions výčtu místo TaskContinuationOptions výčtu

  • Článek
Vlastnost Hodnota
ID pravidla CA2247
Název Argument předaný konstruktoru TaskCompletionSource by měl být výčet TaskCreationOptions, nikoli výčet TaskContinuationOptions
Kategorie Využití
Oprava způsobující chybu nebo chybu způsobující chybu Nenarušující
Povoleno ve výchozím nastavení v .NET 8 Jako upozornění

Příčina

System.Threading.Tasks.TaskCompletionSource Vytvoření výčtové System.Threading.Tasks.TaskContinuationOptions hodnoty místo výčtové System.Threading.Tasks.TaskCreationOptions hodnoty Použití System.Object.ReferenceEquals metody k otestování jednoho nebo více typů hodnot pro rovnost.

Popis pravidla

TaskCompletionSource typ má konstruktor, který přijímá hodnotu výčtu System.Threading.Tasks.TaskCreationOptions a jiný konstruktor, který přijímá .Object Náhodné předání hodnoty výčtu System.Threading.Tasks.TaskContinuationOptions místo hodnoty výčtu System.Threading.Tasks.TaskCreationOptions způsobí volání konstruktoru založeného na parametru Object: bude kompilován a spuštěn, ale nebude mít zamýšlené chování.

Jak opravit porušení

Chcete-li opravit porušení, nahraďte hodnotu výčtu System.Threading.Tasks.TaskContinuationOptions odpovídající System.Threading.Tasks.TaskCreationOptions hodnotou výčtu.

    // Violation
    var tcs = new TaskCompletionSource<int>(TaskContinuationOptions.RunContinuationsAsynchronously);

    // Fixed
    var tcs = new TaskCompletionSource<int>(TaskCreationOptions.RunContinuationsAsynchronously);

Kdy potlačit upozornění

Porušení tohoto pravidla téměř vždy zvýrazní chybu ve volajícím kódu, aby se kód nechoval podle očekávání vývojáře, přičemž TaskCompletionSource efektivně ignoruje zadanou možnost. Jediný čas, kdy je bezpečné potlačit upozornění, je, pokud vývojář skutečně chtěl předat pole jako System.Threading.Tasks.TaskContinuationOptions argument stavu objektu do TaskCompletionSource

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 CA2247
// The code that's violating the rule is on this line.
#pragma warning restore CA2247

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.CA2247.severity = none

Chcete-li tuto celou kategorii pravidel zakázat, nastavte závažnost kategorie na none hodnotu v konfiguračním souboru.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none

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

Viz také