CA1830:在 StringBuilder 上优先使用强类型“追加和插入”方法重载

属性
规则 ID CA1830
标题 在 StringBuilder 上优先使用强类型“追加和插入”方法重载
类别 “性能”
修复是中断修复还是非中断修复 非中断
在 .NET 9 中默认启用 作为建议

原因

调用 StringBuilder AppendInsert 方法时,使用的是对 AppendInsert 方法有专用重载的类型调用 ToString 生成的参数。

规则说明

AppendInsert 为除 String 之外的多种类型提供重载。 在可能的情况下,请首先使用强类型重载,而不是使用 ToString () 和基于字符串的重载。

如何解决冲突

从调用中删除不必要的 ToString()

using System.Text;

class C
{
    int _value;

    // Violation
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value.ToString()).AppendLine();
    }

    // Fixed
    public void Log(StringBuilder destination)
    {
        destination.Append("Value: ").Append(_value).AppendLine();
    }
}

何时禁止显示警告

如果不关心不必要的字符串分配对性能的影响,可禁止显示此规则的冲突警告。

抑制警告

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

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

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

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

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

另请参阅