WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

HashCode.Combine – Werte zu einem Hashcode kombinieren

HashCode.Combine erzeugt aus einer bis acht Werten einen int-Hashcode. Die Methode eignet sich für GetHashCode bei Typen mit feldbasierter Gleichheit. Das Ergebnis ist jedoch weder eine dauerhafte Kennung noch ein Beweis für Gleichheit.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

public static int Combine<T1, T2>(T1 value1, T2 value2);

HashCode.Combine ist eine statische Methode von System.HashCode und ab .NET 10 verfügbar. Die Überladungen akzeptieren eine bis acht Werte und geben einen int zurück. Die angezeigte Syntax gilt für zwei Werte; der Compiler leitet die Typargumente normalerweise ab. Die Überladung mit einem Argument verbessert die Verteilung des Hashcodes eines Werts.

Berücksichtige in einer GetHashCode-Implementierung Felder entsprechend den Regeln von Equals. Gleiche Objekte müssen gleiche Hashcodes haben; gleiche Hashcodes beweisen jedoch keine Gleichheit, da Kollisionen möglich sind. Im Beispiel vergleicht GridPoint X und Y, und HashCode.Combine(X, Y) verwendet dieselben Felder in einer festen Reihenfolge.

Speichere das Ergebnis nicht als dauerhafte Kennung und vergleiche es nicht über mehrere Programmläufe hinweg. HashCode verwendet einen zufälligen Seed für den Prozess, und die Implementierung kann sich zwischen Versionen ändern. Das Beispiel gibt daher Vergleichsergebnisse statt eines numerischen Hashcodes aus.

Verwende für mehr als acht Werte eine HashCode-Instanz, aufeinanderfolgende Aufrufe von Add und abschließend ToHashCode. Add besitzt außerdem eine Überladung mit einem benutzerdefinierten Vergleicher. Diese ist hilfreich, wenn das Hashing benutzerdefinierten Gleichheitsregeln entsprechen muss.

Beispiele

using System;

var first = new GridPoint(3, 7);
var second = new GridPoint(3, 7);

Console.WriteLine(first.Equals(second));
Console.WriteLine(first.GetHashCode() == second.GetHashCode());

readonly struct GridPoint
{
    public GridPoint(int x, int y)
    {
        X = x;
        Y = y;
    }

    public int X { get; }
    public int Y { get; }

    public override bool Equals(object? obj) =>
        obj is GridPoint other && X == other.X && Y == other.Y;

    public override int GetHashCode() => HashCode.Combine(X, Y);
}

Ergebnis

True
True

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen