IEqualityComparer.Equals Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Determines whether the specified objects are equal.

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

Syntax

'Declaration
Function Equals ( _
    x As Object, _
    y As Object _
) As Boolean
bool Equals(
    Object x,
    Object y
)

Parameters

Return Value

Type: System.Boolean
true if the specified objects are equal; otherwise, false.

Exceptions

Exception Condition
ArgumentException

x and y are of different types and neither one can handle comparisons with the other.

Remarks

Implement this method to provide a customized equality comparison for objects.

Notes to Implementers

The Equals method is reflexive, symmetric, and transitive. That is, it returns true if used to compare an object with itself; true for two objects x and y if it is true for y and x; and true for two objects x and z if it is true for x and y and also true for y and z.

Implementations are required to ensure that if the Equals method returns true for two objects x and y, then the value returned by the GetHashCode method for x must equal the value returned for y.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.