• Article

IEqualityComparer<T>.Equals Method

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

Determines whether the specified objects are equal.

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

Syntax

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

bool Equals(
    T x,
    T y
)

Parameters

  • x
    Type: T
    The first object of type T to compare.
  • y
    Type: T
    The second object of type T to compare.

Return Value

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

Remarks

Implement this method to provide a customized equality comparison for type T.

Notes to Implementers

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.

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.

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.