EqualityComparer(T) Class
TOC
Collapse the table of content
Expand the table of content

EqualityComparer<T> Class

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

Provides a base class for implementations of the IEqualityComparer<T> generic interface.

System::Object
  System.Collections.Generic::EqualityComparer<T>

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

No code example is currently available or this language may not be supported.

Type Parameters

T

The type of objects to compare.

The EqualityComparer<T> type exposes the following members.

  NameDescription
Protected methodEqualityComparer<T>Initializes a new instance of the EqualityComparer<T> class.
Top

  NameDescription
Public propertyStatic memberDefaultReturns a default equality comparer for the type specified by the generic argument.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Public methodEquals(T, T)When overridden in a derived class, determines whether two objects of type T are equal.
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCode()Serves as a hash function for a particular type. (Inherited from Object.)
Public methodGetHashCode(T)When overridden in a derived class, serves as a hash function for the specified object for hashing algorithms and data structures, such as a hash table.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIEqualityComparer::EqualsDetermines whether the specified objects are equal.
Explicit interface implemetationPrivate methodIEqualityComparer::GetHashCodeReturns a hash code for the specified object.
Top

Derive from this class to provide a custom implementation of the IEqualityComparer<T> generic interface for use with collection classes such as the Dictionary<TKey, TValue> generic class, or with methods such as List<T>::Sort.

The Default property checks whether type T implements the System::IEquatable<T> generic interface and if so returns an EqualityComparer<T> that uses that implementation. Otherwise it returns an EqualityComparer<T> that uses the overrides of Object::Equals and Object::GetHashCode provided by T.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Show:
© 2017 Microsoft