Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Hashtable.Add (Método)

Agrega un elemento con la clave y el valor especificados a Hashtable.

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

public virtual void Add(
	Object key,
	Object value
)

Parámetros

key
Tipo: System.Object
Clave del elemento que se va a agregar.
value
Tipo: System.Object
Valor del elemento que se va a agregar. El valor puede ser null.

Implementaciones

IDictionary.Add(Object, Object)

ExcepciónCondición
ArgumentNullException

key es null.

ArgumentException

Ya existe un elemento con la misma clave en Hashtable.

NotSupportedException

Hashtable es de solo lectura.

O bien

Hashtable tiene un tamaño fijo.

Una clave no puede ser null, pero un valor sí puede serlo.

Un objeto cuyo estado y valor de código hash no guardan ninguna relación no debería utilizarse normalmente como clave. Por ejemplo, es más conveniente utilizar objetos String como claves que objetos StringBuilder.

También puede utilizar la propiedad Item para agregar nuevos elementos estableciendo el valor de una clave que no existe en Hashtable; por ejemplo, myCollection["myNonexistentKey"] = myValue. Sin embargo, si la clave especificada ya existe en la colección Hashtable, cuando se establezca la propiedad Item se sobrescribirá el valor anterior. En cambio, el método Add no modifica los elementos existentes.

Si Count es menor que la capacidad de Hashtable, este método es una operación O(1). Si es necesario aumentar la capacidad para alojar el nuevo elemento, este método se convierte en una operación O(n), donde n es Count.

En el siguiente ejemplo se muestra cómo agregar elementos a Hashtable.


using System;
using System.Collections;
public class SamplesHashtable  {

   public static void Main()  {

      // Creates and initializes a new Hashtable.
      Hashtable myHT = new Hashtable();
      myHT.Add( "one", "The" );
      myHT.Add( "two", "quick" );
      myHT.Add( "three", "brown" );
      myHT.Add( "four", "fox" );

      // Displays the Hashtable.
      Console.WriteLine( "The Hashtable contains the following:" );
      PrintKeysAndValues( myHT );
   }


   public static void PrintKeysAndValues( Hashtable myHT )  {
      Console.WriteLine( "\t-KEY-\t-VALUE-" );
      foreach ( DictionaryEntry de in myHT )
         Console.WriteLine( "\t{0}:\t{1}", de.Key, de.Value );
      Console.WriteLine();
   }
}
/* 
This code produces the following output.

The Hashtable contains the following:
        -KEY-   -VALUE-
        two:    quick
        three:  brown
        four:   fox
        one:    The
*/ 


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft