KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

System.IEquatable<T> — sterk getypeerde gelijkheid

System.IEquatable<T> definieert Equals(T), een gelijkheidsvergelijking met een sterk getypeerd argument. Een consistente implementatie omvat ook Equals(object), GetHashCode() en de operatoren == en !=, zodat een aangepast type zich voorspelbaar gedraagt in collecties.

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

Syntax

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

Met System.IEquatable<T> kun je gelijkheid voor een specifiek type definiëren; meestal is T het type dat de interface implementeert, zoals bij ItemId : IEquatable<ItemId>. De methode Equals(T) retourneert true wanneer waarden volgens de gekozen regel gelijk zijn. De methode bepaalt geen sorteervolgorde — dat is de taak van IComparable<T>. De interface is beschikbaar in .NET 10; het voorbeeld vereist geen previewfuncties.

Equals(T) hoort reflexief, symmetrisch en transitief te zijn en consistente resultaten te geven zolang de gegevens niet veranderen. Bij een klasse hoort een vergelijking met null false op te leveren. Overschrijf ook Equals(object) en GetHashCode() en zorg dat ze overeenkomen met de sterk getypeerde gelijkheid. De interface definieert zelf niet de operatoren == en !=; als je die aanbiedt, moeten ze dezelfde regel volgen.

EqualityComparer<T>.Default gebruikt IEquatable<T> wanneer het type de interface implementeert. Generieke collecties kunnen daardoor sterk getypeerde gelijkheid gebruiken en boxing van structs tijdens die vergelijking vermijden. Een aangepaste comparer die aan een collectie wordt meegegeven, kan een andere regel toepassen. Een struct expliciet naar object casten veroorzaakt nog steeds boxing, zoals bij de tweede aanroep in het voorbeeld.

Gelijke waarden moeten identieke resultaten van GetHashCode() opleveren, maar identieke hashes bewijzen geen gelijkheid. Wijzig geen gegevens die de gelijkheid of hash bepalen zolang een object als sleutel in Dictionary<TKey,TValue> of als element in HashSet<T> wordt gebruikt. Het voorbeeld gebruikt een onveranderlijke struct: twee id’s waarvan Value gelijk is aan 42 zijn gelijk, dus HashSet<ItemId> weigert het duplicaat.

Voorbeelden

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

Resultaat

True
True
True
True
False
1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen