Hashtable.Add(Object, Object) Metoda

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Hashtable.cs

Přidá prvek se zadaným klíčem a hodnotou do objektu Hashtable.

public:
 virtual void Add(System::Object ^ key, System::Object ^ value);

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

abstract member Add : obj * obj -> unit
override this.Add : obj * obj -> unit

Public Overridable Sub Add (key As Object, value As Object)

Parametry

key

Object

Klíč elementu, který chcete přidat.

value

Object

Hodnota prvku, který chcete přidat. Hodnota může být null.

Implementuje

Add(Object, Object)

Výjimky

ArgumentNullException

key je null.

ArgumentException

Prvek se stejným klíčem již v objektu Hashtable.

NotSupportedException

Je Hashtable jen pro čtení.

nebo

Má Hashtable pevnou velikost.

Příklady

Následující příklad ukazuje, jak přidat elementy Hashtabledo .

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
*/

Imports System.Collections

Public Class SamplesHashtable

    Public Shared Sub Main()

        ' Creates and initializes a new Hashtable.
        Dim myHT As 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)

    End Sub

    Public Shared Sub PrintKeysAndValues(myHT As Hashtable)
        Console.WriteLine(vbTab + "-KEY-" + vbTab + "-VALUE-")
        For Each de As DictionaryEntry In myHT
            Console.WriteLine(vbTab + "{0}:" + vbTab + "{1}", de.Key, de.Value)
        Next
        Console.WriteLine()
    End Sub

End Class


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

Poznámky

Klíč nemůže být null, ale hodnota může být.

Objekt, který nemá žádnou korelaci mezi jeho stavem a hodnotou kódu hash, by se obvykle neměl používat jako klíč. Například objekty String jsou lepší než StringBuilder objekty pro použití jako klíče.

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který neexistuje v objektu Hashtable, například myCollection["myNonexistentKey"] = myValue. Pokud však zadaný klíč již existuje v Hashtable, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Pokud Count je menší než kapacita Hashtable, tato metoda je O(1) operace. Pokud je potřeba zvýšit kapacitu tak, aby vyhovovala novému prvku, stane se O(n) tato metoda operací, kde n je Count.

Viz také

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