OrderedDictionary.Add(Object, Object) Metode

Referensi

Definisi

Ruang nama:: System.Collections.Specialized

Rakitan:: System.dll, System.Collections.Specialized.dll

Rakitan:: System.Collections.Specialized.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: OrderedDictionary.cs

Sumber:: OrderedDictionary.cs

Sumber:: OrderedDictionary.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan entri dengan kunci dan nilai yang ditentukan ke OrderedDictionary dalam koleksi dengan indeks terendah yang tersedia.

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

public void Add (object key, 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)

Parameter

key: Object

Kunci entri yang akan ditambahkan.

value: Object

Nilai entri yang akan ditambahkan. Nilai ini bisa berupa null.

Penerapan

Add(Object, Object)

Pengecualian

NotSupportedException

Koleksi OrderedDictionary bersifat baca-saja.

ArgumentException

Elemen dengan kunci yang sama sudah ada dalam OrderedDictionary koleksi.

Contoh

Contoh kode berikut menunjukkan pembuatan dan populasi OrderedDictionary koleksi. Kode ini adalah bagian dari contoh kode yang lebih besar yang dapat dilihat di 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)

Keterangan

Kunci tidak boleh null, tetapi nilainya bisa.

Anda juga dapat menggunakan Item[] properti untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada dalam OrderedDictionary koleksi; namun, jika kunci yang ditentukan sudah ada di OrderedDictionary, mengatur Item[] properti akan menimpa nilai lama. Sebaliknya, Add metode tidak memodifikasi elemen yang ada tetapi sebaliknya melemparkan ArgumentException.

Berlaku untuk

Bagikan melalui