CKTIS / C#
HashCode.Combine: combinar valores en un código hash
HashCode.Combine genera un código hash de tipo int a partir de uno a ocho valores. Es útil en GetHashCode para tipos cuya igualdad se basa en campos, pero el resultado no es un identificador persistente ni una prueba de igualdad.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine es un método estático de System.HashCode, disponible en .NET 10. Sus sobrecargas aceptan de uno a ocho valores y devuelven un int. La sintaxis mostrada corresponde a dos valores; normalmente, el compilador infiere los argumentos de tipo. La sobrecarga de un argumento mejora la distribución del código hash de un valor.
En una implementación de GetHashCode, incluye los campos de acuerdo con las reglas de Equals. Los objetos iguales deben tener códigos hash iguales; sin embargo, que los códigos coincidan no demuestra que los objetos sean iguales, ya que puede haber colisiones. En el ejemplo, GridPoint compara X e Y, y HashCode.Combine(X, Y) utiliza esos mismos campos en un orden fijo.
No guardes el resultado como identificador persistente ni lo compares entre ejecuciones. HashCode utiliza una semilla aleatoria para el proceso, y su implementación puede cambiar entre versiones. Por eso, el ejemplo muestra los resultados de las comparaciones en lugar de un código hash numérico.
Para más de ocho valores, usa una instancia de HashCode, varias llamadas sucesivas a Add y, al final, ToHashCode. Add también tiene una sobrecarga que acepta un comparador personalizado, útil cuando el hash debe seguir reglas de igualdad personalizadas.
Ejemplos
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);
}Resultado
True True
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.