IEqualityComparer<T> Interfaz

Definición

Espacio de nombres:

System.Collections.Generic

Ensamblado:

System.Runtime.dll

Define métodos para admitir la comparación de igualdad de los objetos.

C#

public interface IEqualityComparer<in T>

Parámetros de tipo

T

Tipo de objetos que se van a comparar.

Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.

Derivado

Microsoft.Extensions.Primitives.StringSegmentComparer

System.Collections.Generic.EqualityComparer<T>

System.Collections.Generic.ReferenceEqualityComparer

System.Data.DataRowComparer<TRow>

System.Numerics.TotalOrderIeee754Comparer<T>

System.Reflection.Metadata.HandleComparer

System.StringComparer

System.Xml.Linq.XNodeEqualityComparer

Ejemplos

En el ejemplo siguiente se agregan objetos personalizados Box a una colección de diccionarios. Los Box objetos se consideran iguales si sus dimensiones son iguales.

C#

using System;
using System.Collections.Generic;

static class Example
{
    static void Main()
    {
        BoxEqualityComparer comparer = new();

        Dictionary<Box, string> boxes = new(comparer);

        AddBox(new Box(4, 3, 4), "red");
        AddBox(new Box(4, 3, 4), "blue");
        AddBox(new Box(3, 4, 3), "green");

        Console.WriteLine($"The dictionary contains {boxes.Count} Box objects.");

        void AddBox(Box box, string name)
        {
            try
            {
                boxes.Add(box, name);
            }
            catch (ArgumentException e)
            {
                Console.WriteLine($"Unable to add {box}: {e.Message}");
            }
        }
    }
}

class Box
{
    public int Height { get; }
    public int Length { get; }
    public int Width { get; }

    public Box(int height, int length, int width)
    {
        Height = height;
        Length = length;
        Width = width;
    }

    public override string ToString() => $"({Height}, {Length}, {Width})";
}

class BoxEqualityComparer : IEqualityComparer<Box>
{
    public bool Equals(Box? b1, Box? b2)
    {
        if (ReferenceEquals(b1, b2))
            return true;

        if (b2 is null || b1 is null)
            return false;

        return b1.Height == b2.Height
            && b1.Length == b2.Length
            && b1.Width == b2.Width;
    }

    public int GetHashCode(Box box) => box.Height ^ box.Length ^ box.Width;
}

// The example displays the following output:
//    Unable to add (4, 3, 4): An item with the same key has already been added.
//    The dictionary contains 2 Box objects.

Comentarios

Esta interfaz permite la implementación de la comparación de igualdad personalizada para las colecciones. Es decir, puede crear su propia definición de igualdad para el tipo Ty especificar que esta definición se use con un tipo de colección que acepte la IEqualityComparer<T> interfaz genérica. En .NET Framework, los constructores del Dictionary<TKey,TValue> tipo de colección genérico aceptan esta interfaz.

La propiedad de la EqualityComparer<T> clase genérica proporciona una Default implementación predeterminada de esta interfaz. La StringComparer clase implementa IEqualityComparer<T> de tipo String.

Esta interfaz solo admite comparaciones de igualdad. La interfaz genérica proporciona IComparer<T> la personalización de comparaciones para ordenar y ordenar.

Se recomienda derivar de la EqualityComparer<T> clase en lugar de implementar la IEqualityComparer<T> interfaz, ya que la clase comprueba la EqualityComparer<T> igualdad mediante el IEquatable<T>.Equals método en lugar del Object.Equals método . Esto es coherente con los Containsmétodos , IndexOf, LastIndexOfy Remove de la Dictionary<TKey,TValue> clase y otras colecciones genéricas.

Métodos

Equals(T, T)	Determina si los objetos especificados son iguales.
GetHashCode(T)	Devuelve un código hash para el objeto especificado.

Se aplica a

Consulte también

• EqualityComparer<T>
• Dictionary<TKey,TValue>
• Dictionary<TKey,TValue>
• IComparer<T>