ROSLYN.PERFORMANCE.CA1862 : Use the 'StringComparison' method overloads to perform case-insensitive string comparisons (C#)

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

ROSLYN.PERFORMANCE.CA1862 : Use the 'StringComparison' method overloads to perform case-insensitive string comparisons (C#)

See Roslyn-Detected C# Warning Classes for more information.

Summary

Avoid calling 'ToLower', 'ToUpper', 'ToLowerInvariant' and 'ToUpperInvariant' to perform case-insensitive string comparisons because they lead to an allocation. Instead, prefer calling the method overloads of 'Contains', 'IndexOf' and 'StartsWith' that take a 'StringComparison' enum value to perform case-insensitive comparisons. Switching to using an overload that takes a 'StringComparison' might cause subtle changes in behavior, so it's important to conduct thorough testing after applying the suggestion. Additionally, if a culturally sensitive comparison is not required, consider using 'StringComparison.OrdinalIgnoreCase'.

This check corresponds to Roslyn rule CA1862. For full rule details, see the Microsoft website: CA1862.

Properties

Class Name	Use the 'StringComparison' method overloads to perform case-insensitive string comparisons (C#)
Significance	reliability
Mnemonic	ROSLYN.PERFORMANCE.CA1862
Categories	None
Availability	Available for C# only.
Enabling	Checks for this warning class are enabled by default. To disable them, add the following WARNING_FILTER rule to the project configuration file. WARNING_FILTER += discard class="Use the 'StringComparison' method overloads to perform case-insensitive string comparisons (C#)"

Relevant Configuration File Parameters

The following configuration file parameters affect checks for this warning class.

To report problems with this documentation, please visit https://support.codesecure.com/.