CKTIS / C#
HashCode.Combine — łączenie wartości w kod skrótu
HashCode.Combine tworzy kod skrótu typu int na podstawie od jednej do ośmiu wartości. Przydaje się w GetHashCode dla typów z równością opartą na polach, ale wynik nie jest trwałym identyfikatorem ani dowodem równości.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine to statyczna metoda typu System.HashCode, dostępna w .NET 10. Jej przeciążenia przyjmują od jednej do ośmiu wartości i zwracają int. Pokazana składnia dotyczy dwóch wartości; kompilator zwykle wnioskuje argumenty typów. Przeciążenie jednoargumentowe poprawia rozproszenie kodu skrótu wartości.
W implementacji GetHashCode uwzględniaj pola zgodnie z regułami Equals. Obiekty równe muszą mieć równe kody skrótu; ten sam kod nie oznacza jednak równości, ponieważ możliwe są kolizje. W przykładzie GridPoint porównuje X i Y, a HashCode.Combine(X, Y) wykorzystuje te same pola w ustalonej kolejności.
Nie zapisuj wyniku jako trwałego identyfikatora ani nie porównuj go między uruchomieniami. HashCode używa losowego ziarna dla procesu, a implementacja może zmieniać się między wersjami. Przykład wypisuje więc wyniki porównań, a nie liczbowy kod skrótu.
Dla więcej niż ośmiu wartości użyj instancji HashCode, kolejnych wywołań Add i końcowego ToHashCode. Add ma również przeciążenie z własnym komparatorem, przydatne, gdy reguły haszowania muszą odpowiadać niestandardowym regułom równości.
Przykłady
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);
}Wynik
True True
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.