ConditionalWeakTable does not release values if values reference the ConditionalWeaktable itself

[pjanotti]

This is a special case described at https://github.com/dotnet/corefx/issues/19765. The issue is if one of the values added to the ConditionalWeakTable references the table itself then one must call Clear (or use one of the other workarounds described on the issue) to ensure that there are no leaks.

This is not mentioned explicit on the docs but seems a special case that should be documented to save users from memory leaks.

[mairaw]

@pjanotti would you like to help us with a PR for this?

[pjanotti]

I can get it started. Should it be a note on the remarks section at https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.conditionalweaktable-2?view=netcore-2.1 ?

[mairaw]

If you'd like it to stand out, then yes! Otherwise, just regular text on the Remarks section @pjanotti. Thanks!