CA2226:运算符应有对称重载
属性 | 值 |
---|---|
规则 ID | CA2226 |
标题 | 运算符应有对称重载 |
类别 | 使用情况 |
修复是中断修复还是非中断修复 | 非中断 |
在 .NET 8 中默认启用 | 否 |
原因
某个类型实现了相等运算符或不等运算符,却未实现相反运算符。
默认情况下,此规则仅查看外部可见的类型,但这是可配置的。
规则说明
不存在相等或不等运算符适用于某个类型的实例却未定义对应的相反运算符的情况。 类型通常通过返回相等运算符的求反值来实现不等运算符。
对于与此规则的冲突,C# 编译器会发出错误。
如何解决冲突
若要解决与此规则的冲突,请同时实现相等和不等运算符,或删除存在的运算符。
何时禁止显示警告
不禁止显示此规则发出的警告。 如果禁止了,类型将无法以与 .NET 一致的方式工作。
配置代码以进行分析
使用下面的选项来配置代码库的哪些部分要运行此规则。
可以仅为此规则、为适用的所有规则或为适用的此类别(使用情况)中的所有规则配置此选项。 有关详细信息,请参阅代码质量规则配置选项。
包含特定的 API 图面
你可以根据代码库的可访问性,配置要针对其运行此规则的部分。 例如,若要指定规则应仅针对非公共 API 图面运行,请将以下键值对添加到项目中的 .editorconfig 文件:
dotnet_code_quality.CAXXXX.api_surface = private, internal