Differences between Dictionary.Clear and new Dictionary()

Question

What are the key differences between Dictionary.Clear and new Dictionary() in C#? Which one is recommended for which cases?

Answer 1

Dictionary.Clear() will remove all of the KeyValue pairs within the dictionary. Doing new Dictionary() will create a new instance of the dictionary.

If, and only if, the old version of the dictionary is not rooted by another reference, creating a new dictionary will make the entire dictionary, and it's contents (which are not rooted elsewhere) available for cleanup by the GC.

Dictionary.Clear() will make the KeyValue pairs available for cleanup.

In practice, both options will tend to have very similar effects. The difference will be what happens when this is used within a method:

void NewDictionary(Dictionary dict)
{
   dict = new Dictionary(); // Just changes the local reference
}

void  ClearDictionary(Dictionary dict)
{
   dict.Clear();
}

// When you use this...
Dictionary myDictionary = ...; // Set up and fill dictionary

NewDictionary(myDictionary);
// myDictionary is unchanged here, since we made a new copy, but didn't change the original instance

ClearDictionary(myDictionary);
// myDictionary is now empty