ValueType.Equals Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Indicates whether this instance and a specified object are equal.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)


Public Overrides Function Equals ( _
    obj As Object _
) As Boolean
public override bool Equals(
    Object obj


Return Value

Type: System..::.Boolean
true if obj and this instance are the same type and represent the same value; otherwise, false.


The default implementation of the Equals method uses reflection to compare the corresponding fields of obj and this instance. Override the Equals method for a particular type to improve the performance of the method and more closely represent the concept of equality for the type.


The following example demonstrates how the Equals method can be overridden by a derived value type.

Public Structure Complex
   Private m_Re As Double
   Private m_Im As Double

   Public Overloads Function Equals(ByVal ob As Object) As Boolean
      If TypeOf ob Is Complex Then
         Dim c As Complex = CType(ob, Complex)
         Return m_Re = c.m_Re And m_Im = c.m_Im
         Return False
      End If
   End Function

   Public Overloads Function GetHashCode() As Integer
      Return m_Re.GetHashCode() ^ m_Im.GetHashCode()
   End Function

End Structure
public struct Complex
   public double m_Re;
   public double m_Im;

   public override bool Equals(object ob)
      if (ob is Complex)
         Complex c = (Complex)ob;
         return m_Re == c.m_Re && m_Im == c.m_Im;
         return false;

   public override int GetHashCode()
      return m_Re.GetHashCode() ^ m_Im.GetHashCode();

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0


Windows Phone

See Also


ValueType Class

System Namespace