C# | SortedDictionary.Add() Method

This is used to add a specified key and value to the sorted dictionary. The elements are sorted according to TKey.

Syntax:

public void Add (TKey key, TValue value);

Parameters:

key: It is the key of the element to add.
value: It is the value of the element to add. The value can be null for reference types.

Exceptions:

• ArgumentNullException : If the key is null.
• ArgumentException : If an element with the same key already exists in the Dictionary.

Below are the programs to illustrate the use of Dictionary<TKey, TValue>.Add() Method:

Example 1:

// C# code to add the specified key
// and value into the SortedDictionary
using System;
using System.Collections.Generic;

class GFG {

    // Driver code
    public static void Main()
    {

        // Create a new SortedDictionary
        // of strings, with string keys.
        SortedDictionary<string, string> myDict =
           new SortedDictionary<string, string>();

        // Adding key/value pairs in myDict
        myDict.Add("Australia", "Canberra");
        myDict.Add("Belgium", "Brussels");
        myDict.Add("Netherlands", "Amsterdam");
        myDict.Add("China", "Beijing");
        myDict.Add("Russia", "Moscow");
        myDict.Add("India", "New Delhi");

        // To get count of key/value
        // pairs in myDict
        Console.WriteLine("Total key/value pairs in"
                 + " myDict are : " + myDict.Count);

        // Displaying the key/value
        // pairs in myDict
        Console.WriteLine("The key/value pairs"
                          + " in myDict are : ");

        foreach(KeyValuePair<string, string> kvp in myDict)
        {
            Console.WriteLine("Key = {0}, Value = {1}",
                              kvp.Key, kvp.Value);
        }
    }
}

Output:

Total key/value pairs in myDict are : 6
The key/value pairs in myDict are : 
Key = Australia, Value = Canberra
Key = Belgium, Value = Brussels
Key = China, Value = Beijing
Key = India, Value = New Delhi
Key = Netherlands, Value = Amsterdam
Key = Russia, Value = Moscow

Example 2:

// C# code to add the specified key
// and value into the SortedDictionary
using System;
using System.Collections.Generic;

class GFG {

    // Driver code
    public static void Main()
    {

        // Create a new SortedDictionary
        // of strings, with string keys.
        SortedDictionary<string, string> myDict =
           new SortedDictionary<string, string>();

        // Adding key/value pairs in myDict
        myDict.Add("Australia", "Canberra");
        myDict.Add("Belgium", "Brussels");
        myDict.Add("Netherlands", "Amsterdam");
        myDict.Add("China", "Beijing");
        myDict.Add("Russia", "Moscow");
        myDict.Add("India", "New Delhi");

        // The Add method throws an
        // exception if the new key is
        // already in the dictionary.
        try {

            myDict.Add("Russia", "Moscow");
        }

        catch (ArgumentException) {

            Console.WriteLine("An element with Key "
                  + "= \"Russia\" already exists.");
        }
    }
}

Output:

An element with Key = "Russia" already exists.

Note:

• A key cannot be null, but a value can be. If the value type TValue is a reference type.
• This method is an O(log n) operation, where n is Count of elements in the SortedDictionary.

Reference:

• https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.sorteddictionary-2.add?view=netframework-4.7.2