Document System.Runtime.AmbiguousImplementationException

[carlossanlop]

Here's the original proposal for the exception: https://github.com/dotnet/corefx/issues/34124

Here's the PR that introduced it: dotnet/coreclr#22280

Adding @MichalStrehovsky who proposed the API and @jkotas who approved it.

[carlossanlop]

CC @joperezr and @bartonjs, who are marked as owners of System.Runtime, but I can see this area is huge. 😃

[MichalStrehovsky]

Do we want to add a remarks section? Something along the lines of:

Normally a compilation error is generated if there are multiple incompatible interface methods implementing another interface method. AmbiguousImplementationException is thrown when a type in a dependent assembly implements an interface from an assembly that was modified.

To resolve the error, a most specific implementation of the interface method has to be provided. Most specific implementation of the interface method can be provided on the class that implements the interface, or on another interface that requires the interface providing the conflicting implementation.

AmbiguousImplementationException uses the HRESULT COR_E_AMBIGUOUSIMPLEMENTATION, that has the value 0x8013106A.

(Took the inspiration from MissingMethodException.)

[carlossanlop]

@MichalStrehovsky I'd be glad to add your remark message. Do you want me to add it to the general <remarks> element, or to a specific constructor?

[rpetrusha]

Thanks for documenting this exception type, @carlossanlop. I've left a comment and a couple of suggestions.

[carlossanlop]

@rpetrusha comments addressed, build passed. Is it good to merge?

[rpetrusha]

Yes, it's good to merge, @carlossanlop. I'll do that now.