Hashtable.Add(Object, Object) Méthode

Définition

Espace de noms:

System.Collections

Assembly:

System.Runtime.dll

Source:

Hashtable.cs

Ajoute un élément avec la clé et la valeur spécifiées dans Hashtable.

C#

public virtual void Add (object key, object? value);

Paramètres

key

Object

Clé de l'élément à ajouter.

value

Object

Valeur de l'élément à ajouter. La valeur peut être null.

Implémente

Add(Object, Object)

Exceptions

ArgumentNullException

key a la valeur null.

ArgumentException

Un élément possédant la même clé existe déjà dans Hashtable.

NotSupportedException

Hashtable est en lecture seule.

- ou -

Hashtable est de taille fixe.

Exemples

L’exemple suivant montre comment ajouter des éléments au Hashtable.

C#

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

   public static void Main()
   {
      // Creates and initializes a new Hashtable.
      var 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{de.Key}:\t{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
*/

Remarques

Une clé ne peut pas être null, mais une valeur peut l’être.

Un objet qui n’a aucune corrélation entre son état et sa valeur de code de hachage ne doit généralement pas être utilisé comme clé. Par exemple, les objets String sont meilleurs que les objets StringBuilder pour une utilisation en tant que clés.

Vous pouvez également utiliser la Item[] propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans ; Hashtablepar exemple, myCollection["myNonexistentKey"] = myValue. Toutefois, si la clé spécifiée existe déjà dans , la Hashtabledéfinition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode ne modifie pas les éléments existants.

Si Count est inférieur à la capacité de Hashtable, cette méthode est une O(1) opération. Si la capacité doit être augmentée pour prendre en charge le nouvel élément, cette méthode devient une O(n) opération, où n est Count.

S’applique à

Voir aussi

• Remove(Object)
• Item[Object]
• Add(Object, Object)