Hashtable.Add(Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Hashtable.cs

öğesine belirtilen anahtara ve değere Hashtablesahip bir öğe ekler.

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)

Parametreler

key

Object

Eklenecek öğenin anahtarı.

value

Object

Eklenecek öğenin değeri. Değeri olabilir null.

Uygulamalar

Add(Object, Object)

Özel durumlar

ArgumentNullException

key, null'e eşittir.

ArgumentException

içinde aynı anahtara sahip bir öğe zaten var Hashtable.

NotSupportedException

Hashtable salt okunurdur.

-veya-

sabit Hashtable bir boyuta sahiptir.

Örnekler

Aşağıdaki örnekte öğesine nasıl öğe ekleneceği gösterilmektedir Hashtable.

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
'

Açıklamalar

Anahtar olamaz null, ancak bir değer olabilir.

Durumuyla karma kod değeri arasında bağıntısı olmayan bir nesne genellikle anahtar olarak kullanılmamalıdır. Örneğin, Dize nesneleri anahtar olarak kullanmak için StringBuilder nesnelerinden daha iyidir.

özelliğini, içinde bulunmayan Item[]bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizHashtable; örneğin, myCollection["myNonexistentKey"] = myValue. Ancak, belirtilen anahtar içinde Hashtablezaten varsa, özelliğini ayarlamak Item[] eski değerin üzerine yazar. Buna karşılık, Add yöntemi mevcut öğeleri değiştirmez.

kapasitesinden CountküçükseHashtable, bu yöntem bir O(1) işlemdir. Kapasitenin yeni öğeye uyum sağlamak için artırılması gerekiyorsa, bu yöntem bir O(n) işlem haline gelir ve burada n olur Count.

Ayrıca bkz.

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