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

定義

名前空間:

System.Collections.Specialized

アセンブリ:

System.Collections.Specialized.dll

ソース:

OrderedDictionary.cs

指定したキーおよび値を持つエントリを、使用できる最小のインデックスを持つ OrderedDictionary コレクションに追加します。

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

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

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

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

パラメーター

key

Object

追加するエントリのキー。

value

Object

追加するエントリの値。 この値は、null の場合もあります。

実装

Add(Object, Object)

例外

NotSupportedException

OrderedDictionary コレクションは読み取り専用です。

ArgumentException

同じキーを持つ要素が、OrderedDictionary コレクションに既に存在します。

例

次のコード例は、コレクションの作成と作成を OrderedDictionary 示しています。 このコードは、 で表示できる大きなコード例の OrderedDictionary一部です。

// Creates and initializes a OrderedDictionary.
OrderedDictionary^ myOrderedDictionary = gcnew OrderedDictionary();
myOrderedDictionary->Add("testKey1", "testValue1");
myOrderedDictionary->Add("testKey2", "testValue2");
myOrderedDictionary->Add("keyToDelete", "valueToDelete");
myOrderedDictionary->Add("testKey3", "testValue3");

ICollection^ keyCollection = myOrderedDictionary->Keys;
ICollection^ valueCollection = myOrderedDictionary->Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary->Count);

// Creates and initializes a OrderedDictionary.
OrderedDictionary myOrderedDictionary = new OrderedDictionary();
myOrderedDictionary.Add("testKey1", "testValue1");
myOrderedDictionary.Add("testKey2", "testValue2");
myOrderedDictionary.Add("keyToDelete", "valueToDelete");
myOrderedDictionary.Add("testKey3", "testValue3");

ICollection keyCollection = myOrderedDictionary.Keys;
ICollection valueCollection = myOrderedDictionary.Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);

' Creates and initializes a OrderedDictionary.
Dim myOrderedDictionary As New OrderedDictionary()
myOrderedDictionary.Add("testKey1", "testValue1")
myOrderedDictionary.Add("testKey2", "testValue2")
myOrderedDictionary.Add("keyToDelete", "valueToDelete")
myOrderedDictionary.Add("testKey3", "testValue3")

Dim keyCollection As ICollection = myOrderedDictionary.Keys
Dim valueCollection As ICollection = myOrderedDictionary.Values

' Display the contents Imports the key and value collections
DisplayContents( _
    keyCollection, valueCollection, myOrderedDictionary.Count)

注釈

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

コレクションに存在OrderedDictionaryしないキーの値を設定することで、 プロパティを使用Item[]して新しい要素を追加することもできます。ただし、指定したキーが に既にOrderedDictionary存在する場合は、 プロパティをItem[]設定すると古い値が上書きされます。 これに対し、 メソッドは既存の要素を Add 変更するのではなく、 をスローします ArgumentException。