Hashtable.Add(Object, Object) メソッド

定義

名前空間:
System.Collections
アセンブリ:
mscorlib.dll, System.Collections.NonGeneric.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll

指定したキーと値を持つ要素を 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)

パラメーター

key
Object

追加する要素のキー。

value
Object

追加する要素の値。 値は nullできます。

実装

Add(Object, Object)

例外

ArgumentNullException

key は nullです。

ArgumentException

同じキーを持つ要素が既に Hashtableに存在します。

NotSupportedException

Hashtableは読み取り専用です。

-または-

Hashtableには固定サイズがあります。

例

次の例は、 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
'

注釈

キーを nullすることはできませんが、値を指定することもできます。

状態とハッシュ コード値の間に相関関係がないオブジェクトは、通常、キーとして使用しないでください。 たとえば、String オブジェクトは、キーとして使用する StringBuilder オブジェクトよりも優れています。

Item[] プロパティを使用して、Hashtableに存在しないキーの値 (myCollection["myNonexistentKey"] = myValueなど) を設定して、新しい要素を追加することもできます。 ただし、指定したキーが既に Hashtableに存在する場合は、 Item[] プロパティを設定すると、古い値が上書きされます。 これに対し、 Add メソッドは既存の要素を変更しません。

CountがHashtableの容量より小さい場合、このメソッドはO(1)操作です。 新しい要素に対応するために容量を増やす必要がある場合、このメソッドは O(n) 操作になり、 n が Count。

適用対象

こちらもご覧ください