Dictionary<TKey, TValue> Constructor (Int32, IEqualityComparer<TKey>)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Initializes a new instance of the Dictionary<TKey, TValue> class that is empty, has the specified initial capacity, and uses the specified IEqualityComparer<T>.

Namespace:  System.Collections.Generic
Assembly:  mscorlib (in mscorlib.dll)

public Dictionary(
	int capacity,
	IEqualityComparer<TKey> comparer


Type: System.Int32
The initial number of elements that the Dictionary<TKey, TValue> can contain.
Type: System.Collections.Generic.IEqualityComparer<TKey>
The IEqualityComparer<T> implementation to use when comparing keys, or null to use the default EqualityComparer<T> for the type of the key.


capacity is less than 0.

Use this constructor with the case-insensitive string comparers provided by the StringComparer class to create dictionaries with case-insensitive string keys.

Every key in a Dictionary<TKey, TValue> must be unique according to the specified comparer.

The capacity of a Dictionary<TKey, TValue> is the number of elements that can be added to the Dictionary<TKey, TValue> before resizing is necessary. As elements are added to a Dictionary<TKey, TValue>, the capacity is automatically increased as required by reallocating the internal array.

If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the Dictionary<TKey, TValue>.

Dictionary<TKey, TValue> requires an equality implementation to determine whether keys are equal. If comparer is null, this constructor uses the default generic equality comparer, EqualityComparer<T>.Default. If type TKey implements the System.IEquatable<T> generic interface, the default equality comparer uses that implementation.

This constructor is an O(1) operation.

The following code example creates a Dictionary<TKey, TValue> with an initial capacity of 5 and a case-insensitive equality comparer for the current culture. The example adds four elements, some with lower-case keys and some with upper-case keys. The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Finally, the example displays the elements in the dictionary.

using System;
using System.Collections.Generic;

public class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      // Create a new dictionary of strings, with string keys, an
      // initial capacity of 5, and a case-insensitive equality 
      // comparer.
      Dictionary<string, string> openWith =
                    new Dictionary<string, string>(5,

      // Add 4 elements to the dictionary. 
      openWith.Add("txt", "notepad.exe");
      openWith.Add("bmp", "paint.exe");
      openWith.Add("DIB", "paint.exe");
      openWith.Add("rtf", "wordpad.exe");

      // Try to add a fifth element with a key that is the same 
      // except for case; this would be allowed with the default
      // comparer.
         openWith.Add("BMP", "paint.exe");
      catch (ArgumentException)
         outputBlock.Text += "\nBMP is already in the dictionary." + "\n";

      // List the contents of the dictionary.
      outputBlock.Text += "\n";
      foreach (KeyValuePair<string, string> kvp in openWith)
         outputBlock.Text += String.Format("Key = {0}, Value = {1}", kvp.Key,
             kvp.Value) + "\n";

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2015 Microsoft