CA1847：对单个字符使用 String.Contains（char）而不是 String.Contains（string）

属性	值
规则 ID	CA1847
标题	对单个字符使用 String.Contains（char）而不是 String.Contains（string）
类别	“性能”
修复是中断修复还是非中断修复	非中断
在 .NET 8 中默认启用	作为建议

原因

String.Contains(string) 在可用时 String.Contains(char) 使用。

搜索单个字符时， String.Contains(char) 性能优于 String.Contains(string)。

通常，只需使用 char 文本而无需使用字符串文本即可解决规则问题。

public bool ContainsLetterI()
{
    var testString = "I am a test string.";
    return testString.Contains("I");
}

Public Function ContainsLetterI() As Boolean
    Dim testString As String = "I am a test string."
    Return testString.Contains("I")
End Function

可将此代码更改为使用 char 文本。

public bool ContainsLetterI()
{
    var testString = "I am a test string.";
    return testString.Contains('I');
}

Public Function ContainsLetterI() As Boolean
    Dim testString As String = "I am a test string."
    Return testString.Contains("I"c)
End Function

如果并不在意所讨论的搜索调用对性能的影响，可禁止显示此规则的冲突警告。

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

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

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

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