El método Dictionary<TKey,TValue>.Add() se utiliza para agregar una clave y un valor específicos al diccionario.
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 de Dictionary<TKey,TValue>.Add() Method :
Ejemplo 1:
// C# code to add the specified key
// and value into the Dictionary
using System;
using System.Collections.Generic;
class GFG {
// Driver code
public static void Main()
{
// Create a new dictionary
// of strings, with string keys.
Dictionary<string, string> myDict =
new Dictionary<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 = Netherlands, Value = Amsterdam Key = China, Value = Beijing Key = Russia, Value = Moscow Key = India, Value = New Delhi
Ejemplo 2:
// C# code to add the specified
// key and value into the Dictionary
using System;
using System.Collections.Generic;
class GFG {
// Driver code
public static void Main()
{
// Create a new dictionary of
// strings, with string keys.
Dictionary<string, string> myDict =
new Dictionary<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 puede serlo si TValue es un tipo de referencia.
- Si Count es menor que la capacidad, este método se aproxima a una operación O(1).
- Si se debe aumentar la capacidad para acomodar el nuevo elemento, este método se convierte en una operación O(n), donde n es Count.
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