dotnet-api-docs icon indicating copy to clipboard operation
dotnet-api-docs copied to clipboard

ToImmutableDictionary extension methods do not document throwing exceptions on key collisions

Open juliusl opened this issue 5 months ago • 2 comments

The current documentation for ToImmutableDictionary does not document that it throws on a key collision.

https://learn.microsoft.com/en-us/dotnet/api/system.collections.immutable.immutabledictionary.toimmutabledictionary?view=net-9.0

When converting a collection from a to b, the intuitive behavior would be to either skip the value or offer a method overload that gives the user an escape hatch. Since, it doesn't appear an escape hatch exists from the current api, I think at minimum this should be documented on the extension methods.

juliusl avatar Jul 16 '25 21:07 juliusl