Among the Linq extensions methods that came with .NET 3.5 is one called Except. This method takes two lists (first and second)
The MSDN docs say:
This method returns those elements in first that do not appear in second. It does not also return those elements in second that do not appear in first.
This appears to be a lie. Review the code below and guess the output:
The User object has overridden the Equals and GetHashCode methods which the Except method use to determine equality. Since there is only one object in list2 that is also “equal” to an object in list1 I would expect (granted the MSDN docs are correct) that list3 would contain three users with the id zero.
The actual result? list3 will only contain ONE user object (with id zero). When I debug I see that Equals is called to compare objects in list1 with each other.
Using reflector I can see why, Except is implemented using the internal class System.Linq.Set:
It starts by adding all items from list2 into the set class then for each item from list1 that can be added to the set it yield returns. This filters all items from list1 that are equal to an item in list2 BUT it also filters all items in list1 that are equal any other item in list1!
Maybe not such a common usage scenario, and I don’t recommend overriding Equals and GetHashCode in this manner. Anyway frustrated by this because I burnt an hour on debugging before figured out it that what was to blame.