CA1858:使用 StartsWith 而不是 IndexOf

属性
规则 ID CA1858
标题 使用 StartsWith 而不是 IndexOf
类别 “性能”
修复是中断修复还是非中断修复 非中断
在 .NET 9 中默认启用 作为建议

原因

调用 String.IndexOf,其结果与零进行比较。

规则说明

与调用 String.IndexOf 相比,调用 String.StartsWith 并将结果与 0 进行比较,以确定字符串若以给定前缀开头是否更高效、更清晰。

IndexOf 搜索整个字符串,而 StartsWith 仅在字符串开头比较。

如何解决冲突

将对 String.IndexOf 的调用替换为对 String.StartsWith 的调用。

示例

以下代码片段演示了 CA1858 冲突:

bool M(string s)
{
    return s.IndexOf("abc") == 0;
}
Function M(s As String) As Boolean
    Return s.IndexOf("abc") = 0
End Function

以下代码片段修复了冲突:

bool M(string s)
{
    return s.StartsWith("abc");
}
Function M(s As String) As Boolean
    Return s.StartsWith("abc")
End Function

何时禁止显示警告

如果不考虑性能,则可以安全地禁止显示此警告。

抑制警告

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

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

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

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

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