Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

System.IEquatable<T> — uguaglianza fortemente tipizzata

System.IEquatable<T> definisce Equals(T), un confronto di uguaglianza con un argomento fortemente tipizzato. Un’implementazione coerente comprende anche Equals(object), GetHashCode() e gli operatori == e !=, così che un tipo personalizzato si comporti in modo prevedibile nelle raccolte.

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

Sintassi

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> consente di definire l’uguaglianza per un tipo specifico; di solito T è il tipo che implementa l’interfaccia, come in ItemId : IEquatable<ItemId>. Il metodo Equals(T) restituisce true quando i valori sono uguali secondo la regola scelta. Non definisce un ordine di ordinamento — questo è il compito di IComparable<T>. L’interfaccia è disponibile in .NET 10; l’esempio non richiede funzionalità in anteprima.

Equals(T) dovrebbe essere riflessivo, simmetrico e transitivo, e fornire risultati coerenti finché i dati non cambiano. Per una classe, il confronto con null dovrebbe restituire false. Esegui l’override anche di Equals(object) e GetHashCode(), mantenendoli coerenti con l’uguaglianza tipizzata. L’interfaccia non definisce direttamente gli operatori == e !=; se li fornisci, devono seguire la stessa regola.

EqualityComparer<T>.Default usa IEquatable<T> quando il tipo lo implementa. In questo modo le raccolte generiche possono usare l’uguaglianza tipizzata ed evitare il boxing delle strutture durante tale confronto. Un comparer personalizzato passato a una raccolta può applicare una regola diversa. Convertire esplicitamente una struttura in object provoca comunque il boxing, come nella seconda chiamata dell’esempio.

I valori uguali devono restituire risultati identici da GetHashCode(), ma hash identici non dimostrano l’uguaglianza. Non modificare i dati che determinano uguaglianza o hash mentre un oggetto è una chiave in Dictionary<TKey,TValue> o un elemento di HashSet<T>. L’esempio usa una struttura immutabile: due identificatori il cui Value è 42 sono uguali, quindi HashSet<ItemId> rifiuta il duplicato.

Esempi

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

Risultato

True
True
True
True
False
1

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