CA1310: StringComparison opgeven voor juistheid

  • Artikel
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 8 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.

Zie ook