你的位置:首页 > ASP.net教程

[ASP.net教程]编写高质量代码改善C#程序的157个建议——建议12: 重写Equals时也要重写GetHashCode


建议12: 重写Equals时也要重写GetHashCode

除非考虑到自定义类型会被用作基于散列的集合的键值;否则,不建议重写Equals方法,因为这会带来一系列的问题。

如果编译上一个建议中的Person这个类型,编译器会提示这样一个信息:

“重写 Object.Equals(object o)但不重写 Object.GetHashCode()”

如果重写Equals方法的时候不重写GetHashCode方法,在使用如FCL中的Dictionary类时,可能隐含一些潜在的Bug。还是针对上一个建议中的Person进行编码,代码如下所示:

  static Dictionary<Person, PersonMoreInfo> PersonValues = new Dictionary<Person, PersonMoreInfo>();   static void Main(string[] args)   {     AddAPerson();     Person mike = new Person("NB123");     //Console.WriteLine(mike.GetHashCode());     Console.WriteLine(PersonValues.ContainsKey(mike));   }      static void AddAPerson()   {     Person mike = new Person("NB123");     PersonMoreInfo mikeValue = new PersonMoreInfo() { SomeInfo = "Mike's info" };     PersonValues.Add(mike, mikeValue);     //Console.WriteLine(mike.GetHashCode());     Console.WriteLine(PersonValues.ContainsKey(mike));   } 

 

本段代码的输出将会是:

True  

False 

理论上来说,在上一个建议中我们已经重写了Person的Equals方法;也就是说,在AddAPerson方法中的mike和Main方法中的 mike属于“值相等”。于是,将该“值”作为key放入Dictionary中,再在某处根据mike将mikeValue取出来,这会是理所当然的事 情。可是,从上面的代码段中我们发现,针对同一个示例,这种结论是正确的,若是针对不同的mike示例,这种结果就有问题了。

基于键值的集合(如上面的Dictionary)会根据Key值来查找Value值。CLR内部会优化这种查找,实际上,最终是根据Key值的 HashCode来查找Value值。代码运行的时候,CLR首先会调用Person类型的GetHashCode,由于发现Person没有实现 GetHashCode,所以CLR最终会调用Object的GetHashCode方法。将上面代码中的两行注释代码去掉,运行程序得到输出,我们会发 现,Main方法和AddAPerson方法中的两个mike的HashCode是不同的。这里需要解释为什么两者实际对应调用的 Object.GetHashCode会不相同。

Object为所有的CLR类型都提供了GetHashCode的默认实现。每new一个对象,CLR都会为该对象生成一个固定的整型值,该整型值 在对象的生存周期内不会改变,而该对象默认的GetHashCode实现就是对该整型值求HashCode。所以,在上面代码中,两个mike对象虽然属 性值都一致,但是它们默认实现的HashCode不一致,这就导致Dictionary中出现异常的行为。若要修正该问题,就必须重写 GetHashCode方法。Person类的一个简单的重写可以是如下的形式:

  public override int GetHashCode()   {     return this.IDCode.GetHashCode();   } 

 

此时再运行本条建议开始时代码的输出,就会发现两者的HashCode是一致的,而Dictionary也会找到相应的键值,输出:True。

细心的读者可能已经发现一个问题,Person类的IDCode属性是一个只读属性。从语法特性本身来讲,可以将IDCode设置为可写;然而从现 实的角度考虑,一个“人”一旦踏入社会,其IDCode就不应该改变,如果要改变,就相当于是另外一个人了。所以,我们应该只实现该IDCode的只读属 性。同理,GetHashCode方法也应该基于那些只读的属性或特性生成HashCode。

GetHashCode方法还存在另外一个问题,它永远只返回一个整型类型,而整型类型的容量显然无法满足字符串的容量,以下的例子就能产生两个同样的HashCode。

  string str1 = "NB0903100006";   string str2 = "NB0904140001";   Console.WriteLine(str1.GetHashCode());   Console.WriteLine(str2.GetHashCode()); 

 

为了减少两个不同类型之间根据字符串产生相同的HashCode的几率,一个稍作改进版本的GetHashCode方法如下:

  public override int GetHashCode()   {     return (System.Reflection.MethodBase.GetCurrentMethod().DeclaringType.FullName + "#" + this.IDCode).GetHashCode();   } 

 

注意 重写Equals方法的同时,也应该实现一个类型安全的接口IEquatable,所以Person类型的最终版本应该如下所示:

  class Person : IEquatable<Person>   {     public string IDCode { get; private set; }        public Person(string idCode)     {       this.IDCode = idCode;     }        public override bool Equals(object obj)     {       return IDCode == (obj as Person).IDCode;     }        public override int GetHashCode()     {       return (System.Reflection.MethodBase.GetCurrentMethod().DeclaringType.FullName + "#" + this.IDCode).GetHashCode();     }        public bool Equals(Person other)     {       return IDCode == other.IDCode;     }   }

 

转自:《编写高质量代码改善C#程序的157个建议》陆敏技