OrderedDictionary.Add(Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections.Specialized

Bütünleştirilmiş Kod:

System.Collections.Specialized.dll

Kaynak:

OrderedDictionary.cs

Belirtilen anahtara ve değere sahip bir girdiyi OrderedDictionary kullanılabilir en düşük dizine sahip koleksiyona ekler.

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)

Parametreler

key

Object

Eklenecek girişin anahtarı.

value

Object

Eklenecek girişin değeri. Bu değer olabilir null.

Uygulamalar

Add(Object, Object)

Özel durumlar

NotSupportedException

Koleksiyon OrderedDictionary salt okunurdur.

ArgumentException

Koleksiyonda OrderedDictionary aynı anahtara sahip bir öğe zaten var.

Örnekler

Aşağıdaki kod örneği bir OrderedDictionary koleksiyonun oluşturulmasını ve popülasyonunu gösterir. Bu kod, adresinde OrderedDictionarygörüntülenebilen daha büyük bir kod örneğinin parçasıdır.

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

Açıklamalar

Anahtar olamaz null, ancak bir değer olabilir.

Özelliğini, koleksiyonda OrderedDictionary bulunmayan bir anahtarın değerini ayarlayarak yeni öğeler eklemek için de kullanabilirsinizItem[]; ancak, belirtilen anahtar içinde OrderedDictionaryzaten varsa, özelliğini ayarlayarak eski değerin Item[] üzerine yazar. Buna karşılık, Add yöntemi var olan öğeleri değiştirmez, bunun yerine oluşturur ArgumentException.