ValueType.GetHashCode Methode

Definitie

Naamruimte:

System

Assembly:

mscorlib.dll

Retourneert de hash-code voor dit exemplaar.

public:
 override int GetHashCode();

public override int GetHashCode();

override this.GetHashCode : unit -> int

Public Overrides Function GetHashCode () As Integer

Retouren

Int32

Een 32-bits geheel getal dat de hashcode voor dit exemplaar is.

Voorbeelden

In het volgende voorbeeld ziet u hoe de GetHashCode methode kan worden overschreven door een afgeleid waardetype.

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();
    }
}

type Complex() =
    member val m_Re = 0. with get, set
    member val m_Im = 0. with get, set

    override this.Equals(ob) =
        match ob with
        | :? Complex as c ->
            this.m_Re = c.m_Re && this.m_Im = c.m_Im
        | _ -> false
        
    override this.GetHashCode() =
        this.m_Re.GetHashCode() ^^^ this.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

Opmerkingen

De GetHashCode methode is van toepassing op typen die zijn afgeleid van ValueType. Een of meer velden van het afgeleide type worden gebruikt om de retourwaarde te berekenen. Als u de methode van GetHashCode het afgeleide type aanroept, is de retourwaarde waarschijnlijk niet geschikt voor gebruik als sleutel in een hash-tabel. Als de waarde van een of meer velden verandert, kan de retourwaarde bovendien ongeschikt worden voor gebruik als sleutel in een hash-tabel. In beide gevallen kunt u overwegen uw eigen implementatie van de GetHashCode methode te schrijven die het concept van een hash-code voor het type nauwkeuriger vertegenwoordigt.

Zie en System.Collections.Hashtablevoor meer informatieObject.GetHashCode.

.NET 9 en hoger wordt de standaardimplementatie van ValueType.GetHashCodeNotSupportedException als InlineArrayAttribute wordt toegepast op het type.

Notities voor Windows Runtime

Wanneer u de methode GetHashCode aanroept in een Windows Runtime-structuur, biedt het standaardgedrag voor waardetypen die GetHashCode niet overschrijven. Dit maakt deel uit van de ondersteuning die .NET biedt voor De Windows Runtime (zie .NET-ondersteuning voor Windows Store-apps en Windows Runtime). Windows Runtime structuren kunnen GetHashCode niet overschrijven, zelfs niet als ze zijn geschreven met C# of Visual Basic, omdat ze geen methoden kunnen hebben. (Bovendien nemen structuren in de Windows Runtime zelf geen ValueType over.) Ze lijken echter ToString, Equals en GetHashCode methoden te hebben wanneer u ze in uw C# of Visual Basic code gebruikt, en .NET biedt het standaardgedrag voor deze methoden.