Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

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.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.