Hashtable.Add(Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Hashtable.cs

öğesine belirtilen anahtar 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ğer olabilir null.

Uygulamalar

Add(Object, Object)

Özel durumlar

ArgumentNullException

key, null değeridir.

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 öğelerin nasıl ekleneceği gösterilmektedir Hashtable.

using namespace System;
using namespace System::Collections;
void PrintKeysAndValues( Hashtable^ myHT );
int main()
{
   
   // Creates and initializes a new Hashtable.
   Hashtable^ myHT = gcnew 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 );
}

void PrintKeysAndValues( Hashtable^ myHT )
{
   Console::WriteLine( "\t-KEY-\t-VALUE-" );
   IEnumerator^ myEnum = myHT->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry de = *safe_cast<DictionaryEntry ^>(myEnum->Current);
      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
 */

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.

Durumu ile 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 Hashtablebir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizItem[]; ö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 küçükse CountHashtable, bu yöntem bir O(1) işlemdir. Yeni öğeye uyum sağlamak için kapasitenin 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)