System.ValueType.Equals Method

Indicates whether this instance and a specified object are equal.

Syntax

public override bool Equals (object obj)

Parameters

obj
The object to compare with the current instance.

Returns

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

Remarks

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.

Note:

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.

Requirements

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