实现IEquatable(Of T)时Equals方法的错误与警告解析

为什么会出现矛盾的错误和警告？ #

• BC30284错误原因：Object基类的Equals方法签名是Function Equals(obj As Object) As Boolean，你写的Equals(other As gridTradingState)签名和基类的不一样，属于方法重载而非重写。Overrides关键字只能用于重写基类中同名且同签名的方法，所以加了会报错。
• BC40005警告原因：去掉Overrides后，这个方法和基类的Equals同名但参数不同，VB默认会认为你是无意隐藏了基类的可重写方法，所以抛出警告提示你确认意图。

你需要同时完成三件事，保证相等性判断的一致性：

1. 实现IEquatable(Of gridTradingState)的强类型Equals方法
2. 重写Object.Equals(Object)方法，复用强类型版本的逻辑
3. 重写GetHashCode方法，保证哈希码与相等性逻辑匹配

示例代码（假设你的类有核心属性需要参与相等性判断）：

Class gridTradingState
    Implements IEquatable(Of gridTradingState)

    ' 示例业务属性，根据实际情况调整
    Public Property GridId As Integer
    Public Property CurrentPrice As Decimal
    Public Property IsActive As Boolean

    ' 实现IEquatable的强类型Equals方法
    Public Function Equals(other As gridTradingState) As Boolean Implements IEquatable(Of gridTradingState).Equals
        ' 处理null情况
        If other Is Nothing Then Return False
        ' 同一实例直接返回True
        If ReferenceEquals(Me, other) Then Return True
        ' 比较核心业务属性，判断是否相等
        Return GridId = other.GridId AndAlso
               CurrentPrice = other.CurrentPrice AndAlso
               IsActive = other.IsActive
    End Function

    ' 重写Object的Equals方法，调用强类型版本
    Public Overrides Function Equals(obj As Object) As Boolean
        ' 先判断对象类型是否匹配
        If TypeOf obj Is gridTradingState Then
            Return Equals(CType(obj, gridTradingState))
        End If
        Return False
    End Function

    ' 重写GetHashCode，基于参与相等性判断的属性计算
    Public Overrides Function GetHashCode() As Integer
        ' 组合属性哈希码，这里用Tuple简化实现（VB.NET 4.0及以上支持）
        Return Tuple.Create(GridId, CurrentPrice, IsActive).GetHashCode()
    End Function
End Class

当你的对象被用于依赖哈希的集合（比如HashSet(Of gridTradingState)、Dictionary(Of gridTradingState, TValue)）时，.NET会先通过GetHashCode快速定位对象所在的哈希桶，再用Equals确认是否为同一对象。

如果只实现Equals不重写GetHashCode，会导致：

• 两个逻辑相等的对象可能返回不同的哈希码，哈希集合会把它们当成不同元素，破坏集合的正确性
• 违反.NET的核心约定：如果两个对象通过Equals返回True，它们的GetHashCode必须相等

内容的提问来源于stack exchange，提问作者user4951