Cette documentation est archivée et n’est pas conservée.

Hashtable.Add, méthode

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

Espace de noms : System.Collections
Assembly : mscorlib (dans mscorlib.dll)

public virtual void Add (
	Object key,
	Object value
)
public void Add (
	Object key, 
	Object value
)
public function Add (
	key : Object, 
	value : Object
)

Paramètres

key

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

value

Valeur de l'élément à ajouter. La valeur peut être référence Null (Nothing en Visual Basic).

Type d'exceptionCondition

ArgumentNullException

key est référence Null (Nothing en Visual Basic).

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.

Une clé ne peut pas être référence Null (Nothing en Visual Basic), contrairement à une valeur.

Il ne faut généralement pas utiliser comme clé un objet qui ne présente aucune corrélation entre son état et la valeur de son code de hachage. Par exemple, il est préférable d'utiliser des objets de type String comme clés plutôt que des objets de type StringBuilder.

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

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

L'exemple suivant illustre l'ajout d'éléments à un objet 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
*/ 

import System.*;
import System.Collections.*;

public class SamplesHashtable
{
    public static void main(String[] args)
    {
        // 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);
    } //main

    public static void PrintKeysAndValues(Hashtable myHT)
    {
        Console.WriteLine("\t-KEY-\t-VALUE-");
        IEnumerator myEnumerator = myHT.GetEnumerator();

		while (myEnumerator.MoveNext()) {
			DictionaryEntry de = (DictionaryEntry)myEnumerator.get_Current();
            Console.WriteLine("\t{0}:\t{1}", de.get_Key(), de.get_Value());
        }
        Console.WriteLine();
    } //PrintKeysAndValues
} //SamplesHashtable

/* 
 This code produces the following output.
 
 The Hashtable contains the following:
         -KEY-   -VALUE-
         two:    quick
         three:  brown
         four:   fox
         one:    The
 */

import System
import System.Collections

// Creates and initializes a new Hashtable.
var myHT : Hashtable = 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)
    
function PrintKeysAndValues(myList : Hashtable){
    var myEnumerator : IDictionaryEnumerator = myList.GetEnumerator()
    Console.WriteLine("\t-KEY-\t-VALUE-")
    while(myEnumerator.MoveNext())
        Console.WriteLine("\t{0}:\t{1}", myEnumerator.Key, myEnumerator.Value)
    Console.WriteLine()
}

// This code produces the following output.
// 
// The Hashtable contains the following:
//     -KEY-    -VALUE-
//     three:   brown
//     four:    fox
//     two:     quick
//     one:     The 

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: