Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
C#

C#: Fix a Struct’s IEquatable Implementation Being Bypassed

- 15.11.26 - ErcanOPAK

🔧 C#: Fix a Struct’s IEquatable Implementation Being Bypassed

Implementing IEquatable<T> on a struct gives a fast, allocation-free Equals(T other) — but C# requires you to ALSO override the inherited object.Equals(object) and GetHashCode() yourself for that optimization to apply everywhere. Any code path that compares the struct through its boxed object form — a non-generic collection, or a call through an object-typed parameter — falls back to the compiler-generated default, which reflects over every field one by one, ignoring your custom logic entirely, and can even produce a different result if your implementation was ever meant to skip a field the default comparison doesn’t know to skip.

🔎 The Problem

public struct CacheKey : IEquatable<CacheKey>
{
    public string Id;
    public DateTime FetchedAt; // intentionally ignored for equality

    public bool Equals(CacheKey other) => Id == other.Id;
    // no override of Equals(object) or GetHashCode() -> boxed comparisons
    // fall back to ValueType.Equals, which compares BOTH fields including FetchedAt
}

✅ Fix: Override the Object-Level Methods Too

  • Whenever a struct implements IEquatable<T>, also explicitly override Equals(object obj) and GetHashCode() — the interface implementation alone does not automatically wire up the inherited object-level methods.
  • Add a unit test that specifically compares two instances through an object-typed reference, since normal day-to-day code that always compares the struct through its concrete type will never exercise the boxed path at all.
  • If the struct intentionally excludes certain fields from equality, make sure that exclusion is implemented identically in Equals(T other), the Equals(object) override, and GetHashCode().

🚨 Why This Is Dangerous

  • Using the struct as a key in a plain Dictionary<TKey, TValue> is usually fine since generic collections call the IEquatable<T> path directly — the danger is specifically older interop code, serialization logic, or any API accepting object parameters without you realizing it bypasses your optimized implementation.

IEquatable<T> is an offer your struct makes to callers who ask for it by type — callers who only have an object in hand never see that offer at all.

— C# Best Practice

Related posts:

String Interpolation, String Format, String Concat and String Builder in C#

String Interpolation, String Format, String Concat and String Builder in C#

Every Async Method Should Accept CancellationToken

Every Async Method Should Accept CancellationToken

C#: Why an Event Handler Keeps a Disposed Object Alive and Leaks Memory

C#: Why an Event Handler Keeps a Disposed Object Alive and Leaks Memory

Views: 2

Post navigation

Docker: Fix a .NET App Crashing Only on Alpine From Missing glibc
The AI Prompt That Finds the One Config Flag Causing Weird Behavior

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (607)
  • Average of all values in a column that are not zero in SQL (569)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (546)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (976)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (852)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com