Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

HashCode.Combine: combinare valori in un codice hash

HashCode.Combine produce un codice hash di tipo int a partire da uno a otto valori. È utile in GetHashCode per i tipi con uguaglianza basata sui campi, ma il risultato non è né un identificatore persistente né una prova di uguaglianza.

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

Sintassi

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

HashCode.Combine è un metodo statico di System.HashCode, disponibile in .NET 10. I suoi overload accettano da uno a otto valori e restituiscono un int. La sintassi mostrata riguarda due valori; in genere il compilatore deduce gli argomenti di tipo. L'overload con un argomento migliora la distribuzione del codice hash di un valore.

Nell'implementazione di GetHashCode, includi i campi in modo coerente con le regole di Equals. Gli oggetti uguali devono avere codici hash uguali; codici uguali, però, non dimostrano l'uguaglianza, perché sono possibili collisioni. Nell'esempio, GridPoint confronta X e Y, e HashCode.Combine(X, Y) usa gli stessi campi in un ordine fisso.

Non salvare il risultato come identificatore persistente e non confrontarlo tra esecuzioni diverse. HashCode usa un seme casuale per il processo e la sua implementazione può cambiare tra le versioni. Perciò l'esempio stampa i risultati dei confronti, non un codice hash numerico.

Per più di otto valori, usa un'istanza di HashCode, chiamate successive a Add e infine ToHashCode. Add dispone anche di un overload che accetta un comparatore personalizzato, utile quando l'hashing deve rispettare regole di uguaglianza personalizzate.

Esempi

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

Risultato

True
True

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti