CA1310: StringComparison opgeven voor juistheid
| Eigenschappen | Weergegeven als |
|---|---|
| Regel-id | CA1310 |
| Titel | StringComparison opgeven voor juistheid |
| Categorie | Globalisatie |
| Oplossing is brekend of niet-brekend | Niet-brekend |
| Standaard ingeschakeld in .NET 9 | Nee |
Oorzaak
Een tekenreeksvergelijkingsbewerking maakt gebruik van een overbelasting van een StringComparison methode die geen parameter instelt en standaard cultuurspecifieke tekenreeksvergelijking gebruikt. Daarom varieert het gedrag ervan op basis van de landinstellingen van de huidige gebruiker.
Beschrijving van regel
Een vergelijkingsmethode voor tekenreeksen die standaard gebruikmaakt van cultuurspecifieke tekenreeksvergelijking kan mogelijk onbedoeld runtimegedrag hebben dat niet overeenkomt met de intentie van de gebruiker. Het wordt aanbevolen om de overbelasting met de StringComparison parameter te gebruiken voor juistheid en duidelijkheid van intentie.
Deze regel markeert tekenreeksvergelijkingsmethoden die standaard gebruikmaken van de cultuurspecifieke StringComparison waarde. Zie Tekenreeksvergelijkingen die gebruikmaken van de huidige cultuur voor meer informatie.
Notitie
Als u schendingen wilt zien voor alle vergelijkingsmethoden voor tekenreeksen, ongeacht de standaardtekenreeksvergelijking die door de methode wordt gebruikt, gebruikt u CA1307: Geef stringComparison op voor duidelijkheid .
Schendingen oplossen
Als u een schending van deze regel wilt oplossen, wijzigt u tekenreeksvergelijkingsmethoden in overbelastingen die de StringComparison opsomming als parameter accepteren. Wijzig bijvoorbeeld String.Compare(str1, str2) in String.Compare(str1, str2, StringComparison.Ordinal).
Wanneer waarschuwingen onderdrukken
Het is veilig om een waarschuwing van deze regel te onderdrukken wanneer de bibliotheek of toepassing niet is bedoeld om te worden gelokaliseerd.
Een waarschuwing onderdrukken
Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.
#pragma warning disable CA1310
// The code that's violating the rule is on this line.
#pragma warning restore CA1310
Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.
[*.{cs,vb}]
dotnet_diagnostic.CA1310.severity = none
Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.
