IEquatable<T> 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义由值类型或类实现的通用方法,旨在创建特定于类型的方法以确定实例的质量。
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>和 等方法Contains
Remove
IndexOf
LastIndexOf
中测试相等性时,泛型集合对象(如 Dictionary<TKey,TValue>、 和 LinkedList<T> )使用 接口。 它应针对可能存储在泛型集合中的任何对象实现。
实施者说明
将 接口的类型 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) |
指示当前对象是否等于同一类型的另一个对象。 |
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈