System.ValueType.Equals Method

Indicates whether this instance and a specified object are equal.


public override bool Equals (object obj)


The object to compare with the current instance.


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


The ValueType.Equals(object) method overrides object.Equals(object) and provides the default implementation of value equality for all value types in the .NET Framework.

If none of the fields of the current instance and obj are reference types, the ValueType.Equals(object) method performs a byte-by-byte comparison of the two objects in memory. Otherwise, it uses reflection to compare the corresponding fields of obj and this instance.


Particularly if your value type contains fields that are reference types, you should override the ValueType.Equals(object) method. This can improve performance and enable you to more closely represent the meaning of equality for the type.

Notes for the wrt

When you call the ValueType.Equals(object) method on a wrt structure, it provides the default behavior for value types that don’t override ValueType.Equals(object). This is part of the support that the .NET Framework provides for the wrt (see .NET Framework Support for Windows Store Apps and Windows Runtime). wrt structures can’t override ValueType.Equals(object), even if they’re written with C# or Visual Basic, because they can’t have methods. (In addition, structures in the wrt itself don’t inherit ValueType.) However, they appear to have ValueType.ToString, ValueType.Equals(object), and ValueType.GetHashCode methods when you use them in your C# or Visual Basic code, and the .NET Framework provides the default behavior for these methods.


Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0,,