CA1855：使用 Span<T>.Clear() 而不是 Span<T>.Fill()

属性	值
规则 ID	CA1855
标题	使用 Span<T>.Clear() 而非 Span<T>.Fill()
类别	“性能”
修复是中断修复还是非中断修复	非中断
在 .NET 9 中默认启用	作为建议

原因

调用 Span<T>.Fill(T) 以使用默认值填充某范围的元素。

规则说明

若要使用默认值填充某范围的元素，调用 Span<T>.Clear() 比调用 Span<T>.Fill(T) 更高效。

如何解决冲突

将对 Span<T>.Fill(T) 的调用替换为对 Span<T>.Clear() 的调用。

示例

以下代码片段演示了 CA1855 冲突：

void M(Span<byte> span)
{
    span.Fill(0);
}

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

void M(Span<byte> span)
{
    span.Clear();
}

何时禁止显示警告

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

抑制警告

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

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

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

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

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