IDictionary.Add(Object, Object) Método

  • Referencia

Definición

Espacio de nombres:
System.Collections
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Agrega un elemento con la clave y el valor proporcionados al objeto IDictionary.

public:
 void Add(System::Object ^ key, System::Object ^ value);
public void Add (object key, object value);
public void Add (object key, object? value);
abstract member Add : obj * obj -> unit
Public Sub Add (key As Object, value As Object)

Parámetros

key
Object

Object que se va a utilizar como clave del elemento que se va a agregar.

value
Object

Object que se va a utilizar como valor del elemento que se va a agregar.

Excepciones

ArgumentNullException

key es null.

ArgumentException

Ya existe un elemento con la misma clave en el objeto IDictionary.

NotSupportedException

IDictionary es de solo lectura.

o bien

IDictionary tiene un tamaño fijo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo implementar el Add método . Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase IDictionary.

public:
    virtual void Add(Object^ key, Object^ value)
    {
        // Add the new key/value pair even if this key already exists
        // in the dictionary.
        if (itemsInUse == items->Length)
        {
            throw gcnew InvalidOperationException
                ("The dictionary cannot hold any more items.");
        }
        items[itemsInUse++] = gcnew DictionaryEntry(key, value);
    }

public void Add(object key, object value)
{
    // Add the new key/value pair even if this key already exists in the dictionary.
    if (ItemsInUse == items.Length)
        throw new InvalidOperationException("The dictionary cannot hold any more items.");
    items[ItemsInUse++] = new DictionaryEntry(key, value);
}

Public Sub Add(ByVal key As Object, ByVal value As Object) Implements IDictionary.Add

    ' Add the new key/value pair even if this key already exists in the dictionary.
    If ItemsInUse = items.Length Then
        Throw New InvalidOperationException("The dictionary cannot hold any more items.")
    End If
    items(ItemsInUse) = New DictionaryEntry(key, value)
    ItemsInUse = ItemsInUse + 1
End Sub

Comentarios

También puede usar la Item[] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en el diccionario (por ejemplo, myCollection["myNonexistentKey"] = myValue). Sin embargo, si la clave especificada ya existe en el diccionario, al establecer la Item[] propiedad se sobrescribe el valor anterior. En cambio, el Add método no modifica los elementos existentes.

Las implementaciones pueden variar en si permiten que la clave sea null.

Se aplica a

Consulte también