Megosztás a következőn keresztül:

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

  • Cikk
Tulajdonság Érték
Szabályazonosító CA1310
Cím StringComparison megadása a helyesség érdekében
Kategória Globalizáció
A javítás kompatibilitástörő vagy nem törik Nem törés
Alapértelmezés szerint engedélyezve a .NET 8-ban Nem

Ok

A sztring-összehasonlító műveletek olyan metódust használnak, amely nem állít be paramétert StringComparison , é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 túlterhelést használja a paraméterrel a StringComparison helyesség és a szándék egyértelműsége é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ó: Az aktuális kultúrát használó 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, a metódus által használt alapértelmezett karakterlánc-összehasonlítástól függetlenül használja a CA1307: Adja meg a StringComparisont az egyértelműség érdekében.

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.

Kapcsolódó információk