Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

IDictionary.Add (Método)

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

Espacio de nombres:  System.Collections
Ensamblado:  mscorlib (en mscorlib.dll)

void Add(
	Object key,
	Object value
)

Parámetros

key
Tipo: System.Object
Object que se va a utilizar como clave del elemento que se va a agregar.
value
Tipo: System.Object
Object que se va a utilizar como valor del elemento que se va a agregar.

ExcepciónCondición
ArgumentNullException

El valor de key es null.

ArgumentException

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

NotSupportedException

IDictionary es de sólo lectura.

O bien

La IDictionary tiene un tamaño fijo.

También puede utilizar la propiedad Item 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 propiedad Item se reemplaza el valor antiguo. En cambio, el método Add no modifica los elementos existentes.

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

En el ejemplo de código siguiente se muestra cómo implementar el método Add. Este ejemplo de código forma parte de un ejemplo más amplio referente a la clase IDictionary.


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);
}


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: