| 属性 | 值 |
|---|---|
| 规则 ID | CA1309 |
| 标题 | 使用按顺序的 StringComparison |
| 类别 | 全球化 |
| 修复是导致破坏性更改还是非破坏性更改 | 非中断 |
| 在 .NET 10 中默认启用 | 否 |
| 适用的语言 | C# 和 Visual Basic |
原因
非语义的字符串比较运算不会将 StringComparison 参数设置为 Ordinal 或 OrdinalIgnoreCase 。
规则说明
许多字符串操作（最重要的是 System.String.Compare 和 System.String.Equals 方法）现在提供重载，后者接受 System.StringComparison 枚举值作为参数。
指定 StringComparison.Ordinal 或 StringComparison.OrdinalIgnoreCase 时，字符串比较是非语义的 。 也就是说，在制定比较决策时，将忽略特定于自然语言的特征。 忽略自然语言特征意味着决策基于简单的字节比较，而不是基于区域性参数化的大小写或等价表。 因此，通过将参数显式设置为 StringComparison.Ordinal 或 StringComparison.OrdinalIgnoreCase，通常可以提高代码的速度、正确性和可靠性 。
如何解决违规
若要解决此规则冲突，请将字符串比较方法改为使用接受System.StringComparison 枚举作为参数的重载方法，并指定Ordinal或OrdinalIgnoreCase。 例如，将 String.Compare(str1, str2) 更改为 String.Compare(str1, str2, StringComparison.Ordinal)。
何时禁止显示警告
当库或应用程序面向有限的本地受众，或者应该使用当前文化语义时，可以选择抑制该规则的警告。
抑制警告
如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。
#pragma warning disable CA1309
// The code that's violating the rule is on this line.
#pragma warning restore CA1309
若要对文件、文件夹或项目禁用该规则，请在none中将其严重性设置为 。
[*.{cs,vb}]
dotnet_diagnostic.CA1309.severity = none
有关详细信息，请参阅如何禁止显示代码分析警告。
