ValueType.GetHashCode Methode

Definition

Gibt den Hashcode für diese Instanz zurück.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

Gibt zurück

Eine 32-Bit-Ganzzahl mit Vorzeichen. Diese ist der Hashcode für die Instanz.A 32-bit signed integer that is the hash code for this instance.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die GetHashCode-Methode von einem abgeleiteten Werttyp überschrieben werden kann.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

Hinweise

Die GetHashCode-Methode gilt für Typen, die von ValueType abgeleitet werden.The GetHashCode method applies to types derived from ValueType. Ein oder mehrere Felder des abgeleiteten Typs werden verwendet, um den Rückgabewert zu berechnen.One or more fields of the derived type is used to calculate the return value. Wenn Sie die GetHashCode-Methode des abgeleiteten Typs aufzurufen, ist der Rückgabewert wahrscheinlich nicht für die Verwendung als Schlüssel in einer Hash Tabelle geeignet.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. Wenn sich der Wert eines oder mehrerer dieser Felder ändert, wird der Rückgabewert möglicherweise ungeeignet für die Verwendung als Schlüssel in einer Hash Tabelle.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. In jedem Fall sollten Sie eine eigene Implementierung der GetHashCode-Methode schreiben, die das Konzept eines Hashcodes für den Typ genauer darstellt.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.

Weitere Informationen finden Sie unter Object.GetHashCode und System.Collections.Hashtable.For more information, see Object.GetHashCode, and System.Collections.Hashtable.

Hinweise für die Windows-RuntimeWindows RuntimeNotes for the Windows-RuntimeWindows Runtime

Wenn Sie die GetHashCode-Methode für eine Windows-RuntimeWindows Runtime-Struktur aufzurufen, wird das Standardverhalten für Werttypen bereitstellt, die GetHashCode nicht überschreiben.When you call the GetHashCode method on a Windows-RuntimeWindows Runtime structure, it provides the default behavior for value types that don't override GetHashCode. Dies ist ein Teil der Unterstützung, die der .NET Framework für die Windows-RuntimeWindows Runtime bietet (siehe .NET Framework Unterstützung für Windows Store-Apps und Windows-Runtime).This is part of the support that the .NET Framework provides for the Windows-RuntimeWindows Runtime (see .NET Framework Support for Windows Store Apps and Windows Runtime). Windows-RuntimeWindows Runtime-Strukturen können GetHashCode nicht überschreiben, auch wenn Sie C# mit oder Visual Basic geschrieben sind, da Sie keine Methoden aufweisen können.structures can't override GetHashCode, even if they're written with C# or Visual Basic, because they can't have methods. (Darüber hinaus erben Strukturen im Windows-RuntimeWindows Runtime selbst nicht ValueType.) Allerdings scheinen Sie ToString-, Equals-und GetHashCode-Methoden zu haben, wenn Sie Sie C# im-oder-Visual Basic Code verwenden, und das .NET Framework stellt das Standardverhalten für diese Methoden bereit.(In addition, structures in the Windows-RuntimeWindows 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.

Gilt für: