IEquatable<T> 接口

  • 参考

定义

命名空间:
System
程序集:
System.Runtime.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

定义由值类型或类实现的通用方法，旨在创建特定于类型的方法以确定实例的质量。

generic <typename T>
public interface class IEquatable
public interface IEquatable<T>
type IEquatable<'T> = interface
Public Interface IEquatable(Of T)

类型参数

T

要比较的对象的类型。

派生

示例

请参阅 方法的示例 IEquatable<T>.Equals 。

注解

此接口由类型实现，其值可以等同 (例如数字类和字符串类) 。 值类型或类实现 Equals 方法，以创建适合确定实例相等性的特定于类型的方法。

注意

接口 IComparable<T> 定义 CompareTo 方法，该方法确定实现类型的实例的排序顺序。 接口 IEquatable<T> 定义 Equals 方法，该方法确定实现类型的实例的相等性。

在 IEquatable<T> 、、 List<T>和 LinkedList<T> 等方法中测试是否相等时， 接口由泛型集合对象（如 IndexOfLastIndexOfDictionary<TKey,TValue>Contains、 和 Remove）使用。 它应该为可能存储在泛型集合中的任何对象实现。

实施者说明

将接口的类型 IEquatable<T> 参数替换为实现此接口的类型。

如果实现 IEquatable<T>，则还应重写 和 GetHashCode() 的Equals(Object)基类实现，以便其行为与 方法的行为Equals(T)一致。 如果确实重写 Equals(Object)，则也会在调用类上的静态 Equals(System.Object, System.Object) 方法时调用重写的实现。 此外，应重载 op_Equality 和 op_Inequality 运算符。 这可确保所有相等性测试返回一致的结果。

有关重写 Equals(Object)的信息，请参阅 Equals(Object)。

对于值类型，应始终实现 IEquatable<T> 和 重写 Equals(Object) 以提高性能。 Equals(Object) 框值类型，并依赖于反射来比较两个值的相等性。 的 Equals(T) 实现和 的 Equals(Object) 替代都应返回一致的结果。

如果实现 IEquatable<T>，则还应实现 IComparable<T> （如果可以对类型的实例进行排序或排序）。 如果类型实现 IComparable<T>，则几乎始终实现 IEquatable<T>。

请注意，在某些设计中，类型支持顺序关系，但相等性可能与排序关系不同。 考虑按 Person 字母顺序排序的类。 两个同名的人排序相同，但不是同一个人。

方法

Equals(T)

指示当前对象是否等于同一类型的另一个对象。

适用于

另请参阅