CA2265:不要将Span<T>与null或default进行比较。

属性 值
规则 ID CA2265
标题 请勿将Span<T>与null或default比较
类别 使用情况
修复是中断修复还是非中断修复 非中断
在 .NET 10 中默认启用 作为警告
适用的语言 C# 和 Visual Basic

原因

Span<T>实例与null或default相比。

规则说明

将一个跨度与 null 或 default 进行比较可能无法实现预期效果。 default和null常量被隐式转换为Span<T>.Empty。

如何解决违规

请删除冗余比较,或改为通过调用 IsEmpty 使代码更加明确。

示例

以下代码片段显示了 CA2265 的两个冲突,以及针对冲突的修复。

Span<int> span = new([1, 2, 3]);
// CA2265 violation.
if (span == null) { }
// CA2265 violation.
if (span == default) { }

// Fixes the violation.
if (span.IsEmpty) { }

何时禁止显示警告

如果本意是将该范围与空范围进行比较,则可以安全地禁止显示此警告。

抑制警告

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

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

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

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

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

另请参阅