IDictionary<TKey,TValue>.Add(TKey, TValue) Método

Definición

Agrega un elemento con la clave y el valor proporcionados a IDictionary<TKey,TValue>.Adds an element with the provided key and value to the IDictionary<TKey,TValue>.

public:
 void Add(TKey key, TValue value);
public void Add (TKey key, TValue value);
abstract member Add : 'Key * 'Value -> unit
Public Sub Add (key As TKey, value As TValue)

Parámetros

key
TKey

Objeto que se va a utilizar como clave del elemento que se va a agregar.The object to use as the key of the element to add.

value
TValue

El objeto que se va a usar como valor del elemento que se va a agregar.The object to use as the value of the element to add.

Excepciones

key es null.key is null.

Ya existe un elemento con la misma clave en IDictionary<TKey,TValue>.An element with the same key already exists in the IDictionary<TKey,TValue>.

Ejemplos

En el ejemplo de código siguiente se crea un Dictionary<TKey,TValue> vacío de cadenas, con claves enteras, y se tiene acceso a ella a través de la interfaz IDictionary<TKey,TValue>.The following code example creates an empty Dictionary<TKey,TValue> of strings, with integer keys, and accesses it through the IDictionary<TKey,TValue> interface. En el ejemplo de código se usa el método Add para agregar algunos elementos.The code example uses the Add method to add some elements. En el ejemplo se muestra que el método Add produce una ArgumentException al intentar agregar una clave duplicada.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Este código forma parte de un ejemplo más grande que se puede compilar y ejecutar.This code is part of a larger example that can be compiled and executed. Vea System.Collections.Generic.IDictionary<TKey,TValue>.See System.Collections.Generic.IDictionary<TKey,TValue>.

// Create a new dictionary of strings, with string keys,
// and access it through the IDictionary generic interface.
IDictionary<String^, String^>^ openWith =
    gcnew Dictionary<String^, String^>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith->Add("txt", "notepad.exe");
openWith->Add("bmp", "paint.exe");
openWith->Add("dib", "paint.exe");
openWith->Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}
// Create a new dictionary of strings, with string keys, 
// and access it through the IDictionary generic interface.
IDictionary<string, string> openWith = 
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no 
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is 
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new dictionary of strings, with string keys, 
' and access it through the IDictionary generic interface.
Dim openWith As IDictionary(Of String, String) = _
    New Dictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Comentarios

También puede utilizar la propiedad Item[TKey] para agregar nuevos elementos estableciendo el valor de una clave que no existe en el diccionario. por ejemplo, myCollection["myNonexistentKey"] = myValue en C# (myCollection("myNonexistentKey") = myValue en Visual Basic).You can also use the Item[TKey] property to add new elements by setting the value of a key that does not exist in the dictionary; for example, myCollection["myNonexistentKey"] = myValue in C# (myCollection("myNonexistentKey") = myValue in Visual Basic). Sin embargo, si la clave especificada ya existe en el diccionario, al establecer la propiedad Item[TKey] se sobrescribe el valor anterior.However, if the specified key already exists in the dictionary, setting the Item[TKey] property overwrites the old value. En cambio, el método Add no modifica los elementos existentes.In contrast, the Add method does not modify existing elements.

Las implementaciones pueden variar en la forma en que determinan la igualdad de objetos; por ejemplo, la clase List<T> usa Comparer<T>.Default, mientras que la clase Dictionary<TKey,TValue> permite al usuario especificar la implementación IComparer<T> que se va a utilizar para comparar las claves.Implementations can vary in how they determine equality of objects; for example, the List<T> class uses Comparer<T>.Default, whereas the Dictionary<TKey,TValue> class allows the user to specify the IComparer<T> implementation to use for comparing keys.

Las implementaciones pueden variar en cuanto a si permiten null``key.Implementations can vary in whether they allow key to be null.

Se aplica a

Consulte también: