CKTIS / C#
System.IEquatable<T> — igualdad con tipo específico
System.IEquatable<T> define Equals(T), una comparación de igualdad con un argumento de tipo específico. Una implementación coherente también incluye Equals(object), GetHashCode() y los operadores == y !=, para que un tipo personalizado se comporte de forma predecible en las colecciones.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
public readonly struct ItemId : System.IEquatable<ItemId>
{
public int Value { get; }
public ItemId(int value) => Value = value;
public bool Equals(ItemId other) => Value == other.Value;
}System.IEquatable<T> permite definir la igualdad para un tipo concreto; normalmente, T es el tipo que implementa la interfaz, como en ItemId : IEquatable<ItemId>. Su método Equals(T) devuelve true cuando los valores son iguales según la regla elegida. No define el orden de clasificación: esa es la función de IComparable<T>. La interfaz está disponible en .NET 10; el ejemplo no requiere funciones en versión preliminar.
Equals(T) debe ser reflexivo, simétrico y transitivo, y ofrecer resultados coherentes mientras los datos no cambien. En una clase, la comparación con null debe devolver false. Sobrescribe también Equals(object) y GetHashCode(), manteniendo la coherencia con la igualdad de tipo específico. La interfaz no define por sí misma los operadores == y !=; si los proporcionas, deben seguir la misma regla.
EqualityComparer<T>.Default usa IEquatable<T> cuando el tipo lo implementa. Así, las colecciones genéricas pueden usar igualdad de tipo específico y evitar el boxing de estructuras durante esa comparación. Un comparador personalizado proporcionado a una colección puede aplicar una regla distinta. Convertir explícitamente una estructura a object sigue provocando boxing, como en la segunda llamada del ejemplo.
Los valores iguales deben devolver resultados idénticos de GetHashCode(), pero los hashes idénticos no demuestran que haya igualdad. No cambies los datos que determinan la igualdad o el hash mientras un objeto sea una clave en Dictionary<TKey,TValue> o un elemento de HashSet<T>. El ejemplo usa una estructura inmutable: dos identificadores cuyo Value es 42 son iguales, por lo que HashSet<ItemId> rechaza el duplicado.
Ejemplos
#nullable enable
using System;
using System.Collections.Generic;
public readonly struct ItemId : IEquatable<ItemId>
{
public int Value { get; }
public ItemId(int value) => Value = value;
public bool Equals(ItemId other) => Value == other.Value;
public override bool Equals(object? obj) =>
obj is ItemId other && Equals(other);
public override int GetHashCode() => Value;
public static bool operator ==(ItemId left, ItemId right) =>
left.Equals(right);
public static bool operator !=(ItemId left, ItemId right) =>
!left.Equals(right);
}
public static class Program
{
public static void Main()
{
var first = new ItemId(42);
var same = new ItemId(42);
var ids = new HashSet<ItemId> { first };
Console.WriteLine(first.Equals(same));
Console.WriteLine(first.Equals((object)same));
Console.WriteLine(first == same);
Console.WriteLine(ids.Contains(same));
Console.WriteLine(ids.Add(same));
Console.WriteLine(ids.Count);
}
}Resultado
True True True True False 1
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.