ValueType.GetHashCode 메서드

정의

이 인스턴스의 해시 코드를 반환합니다.Returns the hash code for this instance.

public:
 override int GetHashCode();
public override int GetHashCode ();
override this.GetHashCode : unit -> int
Public Overrides Function GetHashCode () As Integer

반환

이 인스턴스의 해시 코드인 32비트 부호 있는 정수입니다.A 32-bit signed integer that is the hash code for this instance.

예제

다음 예제에서는 파생 된 값 형식으로 GetHashCode 메서드를 재정의할 수 있는 방법을 보여 줍니다.The following example demonstrates how the GetHashCode method can be overridden by a derived value type.

public ref struct Complex
{
public:
   double m_Re;
   double m_Im;
   virtual bool Equals( Object^ ob ) override
   {
      if ( dynamic_cast<Complex^>(ob) )
      {
         Complex^ c = dynamic_cast<Complex^>(ob);
         return m_Re == c->m_Re && m_Im == c->m_Im;
      }
      else
      {
         return false;
      }
   }

   virtual int GetHashCode() override
   {
      return m_Re.GetHashCode() ^ m_Im.GetHashCode();
   }
};
public struct Complex 
{
    public double m_Re;
    public double m_Im;

    public override bool Equals( object ob ){
        if( ob is Complex ) {
            Complex c = (Complex) ob;
            return m_Re==c.m_Re && m_Im==c.m_Im;
        }
        else {
            return false;
        }
    }

    public override int GetHashCode(){
        return m_Re.GetHashCode() ^ m_Im.GetHashCode();
    }
}
Public Structure Complex
   Private m_Re As Double
   Private m_Im As Double
       
   Public Overloads Function Equals(ob As Object) As Boolean
      If TypeOf ob Is Complex Then
         Dim c As Complex = CType(ob, Complex)
         Return m_Re = c.m_Re And m_Im = c.m_Im
      Else
         Return False
      End If
   End Function
   
   
   Public Overloads Function GetHashCode() As Integer
      Return m_Re.GetHashCode() ^ m_Im.GetHashCode()
   End Function

End Structure

설명

GetHashCode 메서드는 ValueType에서 파생 된 형식에 적용 됩니다.The GetHashCode method applies to types derived from ValueType. 파생 된 형식의 하나 이상의 필드는 반환 값 계산에 사용 됩니다.One or more fields of the derived type is used to calculate the return value. 파생 형식의 GetHashCode 메서드를 호출 하는 경우 반환 값은 해시 테이블에서 키로 사용 하기에 적합 하지 않을 수 있습니다.If you call the derived type's GetHashCode method, the return value is not likely to be suitable for use as a key in a hash table. 또한 해당 필드의 하나 이상의 값이 변경 하는 경우 반환 값은 해시 테이블의 키로 사용 하기에 적합 하지 않은 될 수 있습니다.Additionally, if the value of one or more of those fields changes, the return value might become unsuitable for use as a key in a hash table. 두 경우 모두 형식에 대 한 해시 코드의 개념을 보다 자세히 나타내는 GetHashCode 메서드의 고유한 구현을 작성 하는 것이 좋습니다.In either case, consider writing your own implementation of the GetHashCode method that more closely represents the concept of a hash code for the type.

자세한 내용은 Object.GetHashCodeSystem.Collections.Hashtable 섹션을 참조하십시오.For more information, see Object.GetHashCode, and System.Collections.Hashtable.

Windows 런타임Windows Runtime에 대 한 참고 사항Notes for the Windows 런타임Windows Runtime

Windows 런타임Windows Runtime 구조체에서 GetHashCode 메서드를 호출 하는 경우 GetHashCode를 재정의 하지 않는 값 형식에 대 한 기본 동작을 제공 합니다.When you call the GetHashCode method on a Windows 런타임Windows Runtime structure, it provides the default behavior for value types that don't override GetHashCode. 이는 .NET Framework에서 Windows 런타임Windows Runtime에 대해 제공 하는 지원의 일부입니다 ( Windows 스토어 앱 및 Windows 런타임에 대 한 .NET Framework 지원참조).This is part of the support that the .NET Framework provides for the Windows 런타임Windows Runtime (see .NET Framework Support for Windows Store Apps and Windows Runtime). Windows 런타임Windows Runtime 구조체는 메서드를 가질 수 없기 때문에 Visual Basic 또는 C# 를 사용 하 여 작성 된 경우에도 GetHashCode를 재정의할 수 없습니다.structures can't override GetHashCode, even if they're written with C# or Visual Basic, because they can't have methods. 또한 Windows 런타임Windows Runtime 자체의 구조체는 ValueType를 상속 하지 않습니다. 그러나 C# 또는 Visual Basic 코드에서 사용 하는 경우 ToString, EqualsGetHashCode 메서드를 사용 하는 것 처럼 보이지만 .NET Framework는 이러한 메서드에 대 한 기본 동작을 제공 합니다.(In addition, structures in the Windows 런타임Windows Runtime itself don't inherit ValueType.) However, they appear to have ToString, Equals, and GetHashCode methods when you use them in your C# or Visual Basic code, and the .NET Framework provides the default behavior for these methods.

적용 대상