0Pricing
C# Academy · Lección

Tipos similares a records e igualdad basada en valores (patrón)

Implemente igualdad basada en valores como en los records: sobrescriba Equals/GetHashCode, implemente IEquatable , añada operadores ==/!= y mantenga los tipos inmutables.

Tipos similares a records e igualdad basada en valores (patrón) es una lección gratuita de C# Academy en CoddyKit. Esta es la lección 2 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de C# Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de C# Academy incluye 3 lecciones en total.

Descripción general de los tipos similares a registros

Objetivo: hacer que los objetos se comparen por valor (como los registros) en C# 6.

  • Datos inmutables
  • Reemplace Equals y GetHashCode
  • Implemente IEquatable<T>
  • Opcional: defina ==/!=

Problema de la igualdad por referencia

De forma predeterminada, las clases se comparan por referencia. Dos objetos con los mismos datos no son iguales.

using System;

public class PersonRef
{
  public string First;
  public string Last;
}

public class Program
{
  public static void Main(string[] args)
  {
    PersonRef a = new PersonRef { First = "Ada", Last = "Lovelace" };
    PersonRef b = new PersonRef { First = "Ada", Last = "Lovelace" };

    Console.WriteLine("Reference Equals? " + object.ReferenceEquals(a, b)); // false
    Console.WriteLine("== (default)? " + (a == b)); // false (same as ReferenceEquals for classes)
  }
}

Patrón de clase similar a un registro

Haga que la clase sea inmutable e implemente IEquatable<T>, Equals, GetHashCode y ==/!= para que la igualdad dependa de los datos.

using System;

// Immutable, value-based equality
public sealed class Person : IEquatable<Person>
{
  public string First { get; private set; }
  public string Last  { get; private set; }

  public Person(string first, string last)
  {
    if (string.IsNullOrEmpty(first)) throw new ArgumentException("first");
    if (string.IsNullOrEmpty(last))  throw new ArgumentException("last");
    First = first; Last = last;
  }

  // "With" helper for copy-on-change
  public Person WithFirst(string first) { return new Person(first, Last); }
  public Person WithLast(string last)   { return new Person(First, last); }

  public bool Equals(Person other)
  {
    if (object.ReferenceEquals(other, null)) return false;
    if (object.ReferenceEquals(this, other)) return true;
    return string.Equals(First, other.First) && string.Equals(Last, other.Last);
  }

  public override bool Equals(object obj)
  {
    return Equals(obj as Person);
  }

  public override int GetHashCode()
  {
    unchecked
    {
      int h = 17;
      h = h * 31 + (First == null ? 0 : First.GetHashCode());
      h = h * 31 + (Last  == null ? 0 : Last.GetHashCode());
      return h;
    }
  }

  public static bool operator ==(Person a, Person b)
  {
    if (object.ReferenceEquals(a, b)) return true;
    if ((object)a == null || (object)b == null) return false;
    return a.Equals(b);
  }

  public static bool operator !=(Person a, Person b) { return !(a == b); }
}

public class Program
{
  public static void Main(string[] args)
  {
    Person p1 = new Person("Ada", "Lovelace");
    Person p2 = new Person("Ada", "Lovelace");
    Console.WriteLine("Value Equals? " + (p1 == p2)); // true
    Person p3 = p1.WithLast("King");
    Console.WriteLine("After With: " + (p1 == p3));   // false
  }
}

Patrón de igualdad de structs

Los structs se comparan por sus campos mediante ValueType.Equals de forma predeterminada, pero implementar IEquatable<T> deja clara la intención y el cálculo del hash.

using System;

public struct Point2 : IEquatable<Point2>
{
  public int X;
  public int Y;

  public Point2(int x, int y) { X = x; Y = y; }

  public bool Equals(Point2 other)
  {
    return X == other.X && Y == other.Y;
  }

  public override bool Equals(object obj)
  {
    if (!(obj is Point2)) return false;
    return Equals((Point2)obj);
  }

  public override int GetHashCode()
  {
    unchecked { return (X * 397) ^ Y; }
  }

  public static bool operator ==(Point2 a, Point2 b) { return a.Equals(b); }
  public static bool operator !=(Point2 a, Point2 b) { return !a.Equals(b); }
}

public class Program
{
  public static void Main(string[] args)
  {
    Point2 a = new Point2(1, 2);
    Point2 b = new Point2(1, 2);
    Console.WriteLine("Struct value equality: " + (a == b)); // true
  }
}

Objetos de valor como claves

Cuando un objeto de valor es una clave de Dictionary, una implementación correcta de Equals/GetHashCode garantiza que las búsquedas funcionen.

using System;
using System.Collections.Generic;

public sealed class Email : IEquatable<Email>
{
  public string Address { get; private set; }
  public Email(string address)
  {
    if (string.IsNullOrEmpty(address)) throw new ArgumentException("address");
    Address = address.Trim().ToLowerInvariant();
  }

  public bool Equals(Email other)
  {
    if (object.ReferenceEquals(other, null)) return false;
    return Address == other.Address;
  }

  public override bool Equals(object obj) { return Equals(obj as Email); }

  public override int GetHashCode()
  {
    return Address == null ? 0 : Address.GetHashCode();
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Dictionary<Email, string> owners = new Dictionary<Email, string>();
    owners[new Email("User@Mail.com")] = "Ada";
    Console.WriteLine(owners.ContainsKey(new Email("user@mail.com"))); // true
  }
}

Lista de comprobación de igualdad

Lista de comprobación:

  • Mantenga los datos inmutables.
  • Reemplace Equals y GetHashCode.
  • Implemente IEquatable<T> para comparaciones rápidas y seguras para el tipo.
  • Añada ==/!= por comodidad.
  • Use los mismos campos tanto para la igualdad como para el cálculo del hash.

Requisito de igualdad similar a un registro

Comprobación rápida: para que una clase se comporte como un valor (como un registro) en C# 6, ¿qué debe hacer?

Repaso

Repaso: en C# 6, cree manualmente tipos similares a registros: datos inmutables, IEquatable<T>, implementaciones correctas de Equals/GetHashCode y, opcionalmente, ==/!=. Úselos de forma segura en conjuntos y diccionarios.

Preguntas frecuentes

¿La lección «Tipos similares a records e igualdad basada en valores (patrón)» es gratis?

Sí — el texto completo de «Tipos similares a records e igualdad basada en valores (patrón)» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de C# Academy, actualiza a CoddyKit PRO. El curso de C# Academy incluye 3 lecciones en total.

¿Qué aprenderé en «Tipos similares a records e igualdad basada en valores (patrón)»?

Implemente igualdad basada en valores como en los records: sobrescriba Equals/GetHashCode, implemente IEquatable , añada operadores ==/!= y mantenga los tipos inmutables. Practicas C# Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar C# Academy?

No se requiere experiencia previa. C# Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 3.

¿Cuánto tiempo toma la lección «Tipos similares a records e igualdad basada en valores (patrón)»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de C# Academy?

Sí. Cada lección de C# Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Structs: semántica de valor y patrón de inmutabilidad
  2. Tipos similares a records e igualdad basada en valores (patrón)
  3. Enums y [Flags]
← Volver a C# Academy