Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

System.IEquatable<T> — tipsko določena enakost

System.IEquatable<T> določa Equals(T), primerjavo enakosti z argumentom določenega tipa. Dosledna implementacija vključuje tudi Equals(object), GetHashCode() ter operatorja == in !=, da se uporabniški tip v zbirkah obnaša predvidljivo.

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

Sintaksa

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> omogoča določanje enakosti za določen tip; običajno je T tip, ki implementira vmesnik, na primer ItemId : IEquatable<ItemId>. Metoda Equals(T) vrne true, kadar so vrednosti po izbranem pravilu enake. Ne določa vrstnega reda razvrščanja — to je naloga vmesnika IComparable<T>. Vmesnik je na voljo v .NET 10; primer ne zahteva funkcij preview.

Equals(T) mora biti refleksivna, simetrična in tranzitivna ter ob nespremenjenih podatkih vračati dosledne rezultate. Pri razredu mora primerjava z null vrniti false. Prepišite tudi Equals(object) in GetHashCode() ter poskrbite, da sta skladni s tipsko določeno enakostjo. Vmesnik sam ne določa operatorjev == in !=; če ju ponudite, morata upoštevati isto pravilo.

EqualityComparer<T>.Default uporablja IEquatable<T>, kadar tip implementira ta vmesnik. Generične zbirke lahko tako uporabljajo tipsko določeno enakost in se med to primerjavo izognejo pakiranju struktur. Lastni primerjalnik, posredovan zbirki, lahko uporabi drugačno pravilo. Izrecna pretvorba strukture v object še vedno povzroči pakiranje, kot pri drugem klicu v primeru.

Enake vrednosti morajo vrniti enake rezultate metode GetHashCode(), vendar enaki zgoščeni vrednosti ne dokazujeta enakosti. Ne spreminjajte podatkov, ki določajo enakost ali zgoščeno vrednost, dokler je objekt ključ v Dictionary<TKey,TValue> ali element v HashSet<T>. Primer uporablja nespremenljivo strukturo: dva identifikatorja, pri katerih je Value enak 42, sta enaka, zato HashSet<ItemId> zavrne dvojnik.

Primeri

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

Rezultat

True
True
True
True
False
1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri