Udostępnij za pośrednictwem


CA2251: Użyj za pośrednictwem String.EqualsString.Compare

Właściwości Wartość
Identyfikator reguły CA2251
Tytuł Użyj String.Equals za pośrednictwem String.Compare
Kategoria Użycie
Poprawka powodująca niezgodność lub niezgodność Niezgodność
Domyślnie włączone na platformie .NET 9 Nie.

Przyczyna

Wynik wywołania metody jest String.Compare porównywany z zerem.

Opis reguły

String.Compare jest przeznaczony do tworzenia porównania całkowitej kolejności, które można użyć do sortowania. Jeśli interesuje Cię tylko to, czy ciągi są równe, jest to zarówno jaśniejsze, jak i prawdopodobnie szybsze użycie równoważnego String.Equalsprzeciążenia .

Jak naprawić naruszenia

Aby naprawić naruszenia tej reguły, zastąp wyrażenie porównujące wynik z String.Compare wywołaniem funkcji String.Equals.

Kiedy pomijać ostrzeżenia

Można bezpiecznie pominąć ostrzeżenia z tej reguły.

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

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

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

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

Zobacz też