Esto se usa para agregar una clave y un valor especificados al diccionario ordenado. Los elementos se ordenan según TKey.
Sintaxis:
public void Add (TKey key, TValue value);
Parámetros:
clave: Es la clave del elemento a sumar.
value: Es el valor del elemento a sumar. El valor puede ser nulo para los tipos de referencia.
Excepciones:
- ArgumentNullException: si la clave es nula.
- ArgumentException: si un elemento con la misma clave ya existe en el Diccionario.
A continuación se muestran los programas para ilustrar el uso del método Dictionary<TKey, TValue>.Add():
Ejemplo 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);
}
}
}
Producción:
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
Ejemplo 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.");
}
}
}
Producción:
An element with Key = "Russia" already exists.
Nota:
- Una clave no puede ser nula, pero un valor sí puede serlo. Si el tipo de valor TValue es un tipo de referencia.
- Este método es una operación O(log n), donde n es el recuento de elementos en SortedDictionary.
Referencia:
Publicación traducida automáticamente
Artículo escrito por rupesh_rao y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA