CA2251:使用 String.Equals 代替 String.Compare

属性
规则 ID CA2251
标题 String.Compare 使用 String.Equals
类别 使用情况
修复是中断修复还是非中断修复 非中断
在 .NET 9 中默认启用

原因

String.Compare 的调用结果与零进行比较。

规则说明

String.Compare 旨在生成可用于排序的总顺序比较。 如果只关心字符串是否相等,使用 String.Equals 的等效重载会更清晰且可能更快。

如何解决冲突

若要解决此规则的冲突,请将比较 String.Compare 结果的表达式替换为对 String.Equals 的调用。

何时禁止显示警告

可以安全地禁止显示此规则的警告。

抑制警告

如果只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用该规则。

#pragma warning disable CA2251
// The code that's violating the rule is on this line.
#pragma warning restore CA2251

若要对文件、文件夹或项目禁用该规则,请在配置文件中将其严重性设置为 none

[*.{cs,vb}]
dotnet_diagnostic.CA2251.severity = none

有关详细信息,请参阅如何禁止显示代码分析警告

另请参阅