PropertyCollection.IDictionary.Add(Object, Object) Metode

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Sumber:

PropertyCollection.cs

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

Add(Object, Object)

Pengecualian

ArgumentNullException

keyadalah null.

ArgumentException

Elemen dengan kunci yang sama sudah ada di IDictionary objek .

NotSupportedException

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.

Lihat juga

• Item[Object]