MSTEST0021: preferuj metodę Dispose za pośrednictwem metody TestCleanup

Właściwości	Wartość
Identyfikator reguły	MSTEST0021
Tytuł	Preferuj usuwanie za pośrednictwem metod TestCleanup
Kategoria	Projektowanie
Poprawka powodująca niezgodność lub niezgodność	Niezgodność
Domyślnie włączone	Nie.
Ważność domyślna	Informacje
Wprowadzone w wersji	3.4.0
czy istnieje poprawka kodu	Tak, począwszy od wersji 3.7.0

Przyczyna

Ta reguła zgłasza diagnostykę, gdy istnieje metoda void [TestCleanup] lub w dowolnym [TestCleanup] przypadku, jeśli platforma docelowa obsługuje IAsyncDisposable interfejs.

Opis reguły

Użycie Dispose lub DisposeAsync jest bardziej typowym wzorcem, a niektórzy deweloperzy wolą zawsze używać tego wzorca nawet w przypadku testów.

Jak naprawić naruszenia

Zastąp [TestCleanup] metodę metodą Dispose lub DisposeAsync wzorcem.

Kiedy pomijać ostrzeżenia

Zwykle nie chcesz pomijać ostrzeżeń z tej reguły, jeśli zdecydujesz się na to zgodę.

Uwaga

Ta reguła jest włączona. Nie jest ona włączona nawet w przypadku korzystania z <MSTestAnalysisMode>All</MSTestAnalysisMode>. Aby uzyskać więcej informacji na temat MSTestAnalysisMode, zobacz analizę kodu MSTest .

Pomijanie ostrzeżenia

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

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

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

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

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