Bagikan melalui


PropertyCollection.IDictionary.Add(Object, Object) Metode

Definisi

Menambahkan elemen dengan kunci dan nilai yang disediakan ke IDictionary objek .

 virtual void System.Collections.IDictionary.Add(System::Object ^ key, System::Object ^ value) = System::Collections::IDictionary::Add;
void IDictionary.Add (object key, object value);
abstract member System.Collections.IDictionary.Add : obj * obj -> unit
override this.System.Collections.IDictionary.Add : obj * obj -> unit
Sub Add (key As Object, value As Object) Implements IDictionary.Add

Parameter

key
Object

Object untuk digunakan sebagai kunci elemen yang akan ditambahkan.

value
Object

untuk Object digunakan sebagai nilai elemen yang akan ditambahkan.

Penerapan

Pengecualian

keyadalah null.

Elemen dengan kunci yang sama sudah ada di IDictionary objek .

IDictionary bersifat baca-saja.

-atau-

memiliki IDictionary ukuran tetap.

Contoh

Contoh berikut menunjukkan cara menerapkan Add metode . Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk IDictionary kelas .

public:
    virtual void Add(Object^ key, Object^ value)
    {
        // Add the new key/value pair even if this key already exists
        // in the dictionary.
        if (itemsInUse == items->Length)
        {
            throw gcnew InvalidOperationException
                ("The dictionary cannot hold any more items.");
        }
        items[itemsInUse++] = gcnew DictionaryEntry(key, value);
    }
public void Add(object key, object value)
{
    // Add the new key/value pair even if this key already exists in the dictionary.
    if (ItemsInUse == items.Length)
        throw new InvalidOperationException("The dictionary cannot hold any more items.");
    items[ItemsInUse++] = new DictionaryEntry(key, value);
}
Public Sub Add(ByVal key As Object, ByVal value As Object) Implements IDictionary.Add

    ' Add the new key/value pair even if this key already exists in the dictionary.
    If ItemsInUse = items.Length Then
        Throw New InvalidOperationException("The dictionary cannot hold any more items.")
    End If
    items(ItemsInUse) = New DictionaryEntry(key, value)
    ItemsInUse = ItemsInUse + 1
End Sub

Keterangan

Anda juga dapat menggunakan Item[] properti untuk menambahkan elemen baru dengan mengatur nilai kunci yang tidak ada dalam kamus (misalnya, myCollection["myNonexistentKey"] = myValue). Namun, jika kunci yang ditentukan sudah ada dalam kamus, mengatur Item[] properti akan menimpa nilai lama. Sebaliknya, Add metode tidak memodifikasi elemen yang ada.

Berlaku untuk

Lihat juga