{"componentChunkName":"component---src-pages-markdown-remark-fields-slug-js","path":"/engineering/how-to-create-and-use-dictionary-csharp/","result":{"data":{"markdownRemark":{"id":"9335814f-04d3-5bc1-981f-cda1772f1001","excerpt":"Introduction Dictionaries Dictionary is used for storing a key-value pair. It is a generic collection that is defined in the System.Collection…","html":"

Introduction

\n

Dictionaries Dictionary<TKey, TValue> is used for storing a key-value pair. It is a generic collection that is defined in the System.Collection.Generic namespace and implements the IDictionary<TKey, TValue> interface.

\n

Create a dictionary

\n

Suppose we want to store the scores of a player in a cricket match, Then we have to save the key as the name of the player and score as value.

\n

To create a dictionary of key and value type as a string and int, respectively, we just simply need to initialize as below.

\n
Dictionary<string, int> dict = new Dictionary<string, int>();\nDictionary<string, int> dict1 = new Dictionary<string, int>(5); // Creates a dictionary with default initial capacity of 5
\n

The first line will create a dictionary with string type of key and int type of value and will have the initial default capacity as well default equality comparer for the key type.

\n

The Second line will create the same dictionary as line 1 except for the initial default capacity. It will create a dictionary with an initial default capacity of 5.

\n

We can create the dictionary by using the different constructors of the dictionary. Here I have talked about the two constructors only.

\n

Add elements

\n

We can add the elements in the dictionary by using add method of it.

\n
dict.Add("Player",42);\ndict.Add("Player1",38);
\n

It will add the elements in the dictionary.

\n

Note: Keys can not be null or duplicate. If we add the duplicate or null as a key, then the application will throw the run time exception, but Values can be null or duplicate.

\n

Traverse

\n

To traverse through a dictionary, we can use a foreach loop or a for a loop.

\n

foreach loop

\n
foreach (var item in dict)\n{\n    Console.WriteLine("Key "+ item.Key +" Value "+ item.Value);\n}
\n

for loop

\n
for (int i = 0; i < dict.Count; i++)\n{\n     Console.WriteLine("Key " + dict.ElementAt(i).Key + " Value " + dict.ElementAt(i).Value);\n}
\n

In the above code, we are using the

\n
    \n
  1. Key Property of dictionary element which will return the Key of the dictionary element.
    2. \n
  2. Value Property of dictionary element, which will return the value of the dictionary element.
    3. \n
  3. Count Property which will return the number of elements in the dictionary.
    4. \n
  4. ElementAt(int index) method of a dictionary, which will return the element at the specified index.
    5. \n
\n

Get/Update specified key's value

\n

To get the specified key's value from the dictionary, we can directly use the key as an index.

\n
Console.WriteLine(dict["Player"]); // Prints 42\nConsole.WriteLine(dict["Player1"]); // Prints 38
\n

To update the specified key's value of the dictionary, we can set it as below.

\n
dict["Player"]=45;\nConsole.WriteLine(dict["Player1"]); // Prints 45
\n

Note:

\n
    \n
  1. It will give the run time exception if the given key is not present in the dictionary, and we try to access the value of that key so we can first check for the key using the ContainsKey(TKey) method of the dictionary which will return true/false if the key is present or not in the dictionary.
    2. \n
  2. Suppose if we want to set the value of a key that is not present in the dictionary, then it will automatically add that element into the dictionary and sets the value of it.
    3. \n
\n

Remove

\n

To remove elements from a dictionary, we can use the below methods.

\n

Remove specific key

\n

To remove a specific key, we can use the Remove(TKey) method of the dictionary.

\n
dict.Remove("Player1"); // Removes Player1 from dictionary
\n

Clear dictionary

\n

To clear all the elements of the dictionary, we can use the Clear() method of the dictionary.

\n
dict.Clear(); // Clears all the elements and count will be 0
\n

Conclusion

\n

In this article, We have learned about some of the basics of dictionaries. Dictionaries help to use to manage data in Key-Value pair, which we can easily access and manipulate the data accordingly.

\n","headings":[{"value":"Introduction","depth":2},{"value":"Create a dictionary","depth":2},{"value":"Add elements","depth":2},{"value":"Traverse","depth":2},{"value":"foreach loop","depth":3},{"value":"for loop","depth":3},{"value":"Get/Update specified key's value","depth":2},{"value":"Remove","depth":2},{"value":"Remove specific key","depth":3},{"value":"Clear dictionary","depth":3},{"value":"Conclusion","depth":2}],"fields":{"slug":"/engineering/how-to-create-and-use-dictionary-csharp/"},"frontmatter":{"metatitle":null,"metadescription":null,"description":"In this article, we will talk about how to create and use the Dictionary in C#.","title":"How to create and use the Dictionary in C#","canonical":null,"date":"May 27, 2021","updated_date":null,"tags":["C#","Dictionary"],"coverImage":{"childImageSharp":{"fluid":{"aspectRatio":1.5037593984962405,"src":"/static/70d1172c5171ae195aeb525bdf6086b3/03979/coverimage.png","srcSet":"/static/70d1172c5171ae195aeb525bdf6086b3/f5f11/coverimage.png 200w,\n/static/70d1172c5171ae195aeb525bdf6086b3/6d133/coverimage.png 400w,\n/static/70d1172c5171ae195aeb525bdf6086b3/03979/coverimage.png 800w,\n/static/70d1172c5171ae195aeb525bdf6086b3/aca38/coverimage.png 1200w","sizes":"(max-width: 800px) 100vw, 800px"}}},"author":{"id":"Hemant Manwani","github":"hemant404","bio":"Hemant Manwani is a Software Engineer at LoginRadius who is interested in how the web works and developer tools that make working with web easier.","avatar":null}}}},"pageContext":{"id":"9335814f-04d3-5bc1-981f-cda1772f1001","fields__slug":"/engineering/how-to-create-and-use-dictionary-csharp/","__params":{"fields__slug":"engineering"}}},"staticQueryHashes":["1171199041","1384082988","1711371485","1753898100","2100481360","229320306","23180105","528864852"]}