CA1310: StringComparison megadása a helyesség érdekében

Tulajdonság Érték
Szabályazonosító CA1310
Cím StringComparison megadása a pontos működés érdekében
Kategória Globalizáció
A javítás romboló vagy nem romboló Nem törhető
Alapértelmezés szerint engedélyezve a .NET 10-ben Nem
Alkalmazandó nyelvek C# és Visual Basic

Ok

A sztring-összehasonlító művelet olyan metódust használ, amely túlterhelést alkalmaz, nem állít be StringComparison paramétert, és alapértelmezés szerint kultúraspecifikus sztring-összehasonlítást használ. Ezért a viselkedése az aktuális felhasználó területi beállításaitól függően változik.

Szabály leírása

A kultúraspecifikus sztring-összehasonlítást alapértelmezés szerint használó sztring-összehasonlítási módszer esetleg nem szándékos futtatókörnyezeti viselkedéssel rendelkezhet, amely nem felel meg a felhasználói szándéknak. Javasoljuk, hogy a StringComparison paraméterrel ellátott metódustúlterhelést használja a helyesség és a szándék világos kifejezése érdekében.

Ez a szabály alapértelmezés szerint a kultúraspecifikus StringComparison értéket használó sztring-összehasonlító módszereket jelöli. További információkért lásd: az aktuális kultúra szerinti sztring-összehasonlítások.

Megjegyzés

Ha az összes sztring-összehasonlítási módszer esetében meg szeretné jeleníteni a szabálysértéseket, függetlenül a metódus által használt alapértelmezett karakterlánc-összehasonlítástól, kérjük, használja a CA1307: Adja meg a StringComparison értékét az átláthatóság kedvéért.

Szabálysértések kijavítása

A szabály megsértésének kijavításához módosítsa a sztring-összehasonlító metódusokat olyan túlterhelésekre, amelyek paraméterként elfogadják az StringComparison enumerálást. Például váltson a String.Compare(str1, str2) következőre String.Compare(str1, str2, StringComparison.Ordinal): .

Mikor kell letiltani a figyelmeztetéseket?

Biztonságosan letilthatja a szabály figyelmeztetését, ha a kódtár vagy alkalmazás nem honosításra szolgál.

Figyelmeztetés mellőzése

Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.

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

Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none a konfigurációs fájlban.

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

További információ: Kódelemzési figyelmeztetések letiltása.

Lásd még

  • Last updated on