IDictionary.Add(Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kod:

System.Runtime.dll

Sağlanan anahtar ve değere sahip bir öğeyi nesnesine IDictionary ekler.

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

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

abstract member Add : obj * obj -> unit

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

Parametreler

key

Object

Object eklenecek öğenin anahtarı olarak kullanılacak.

value

Object

Object eklenecek öğenin değeri olarak kullanılacak.

Özel durumlar

ArgumentNullException

key, null değeridir.

ArgumentException

Nesnesinde IDictionary aynı anahtara sahip bir öğe zaten var.

NotSupportedException

IDictionary salt okunurdur.

-veya-

sabit IDictionary bir boyuta sahiptir.

Örnekler

Aşağıdaki kod örneği, yönteminin Add nasıl uygulanduğunu gösterir. Bu kod örneği, sınıfı için IDictionary sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Özelliğini, sözlükte Item[] bulunmayan bir anahtarın değerini ayarlayarak (örneğin, myCollection["myNonexistentKey"] = myValue) yeni öğeler eklemek için de kullanabilirsiniz. Ancak, belirtilen anahtar sözlükte zaten varsa, özelliğini ayarlamak Item[] eski değerin üzerine yazar. Buna karşılık, Add yöntemi mevcut öğeleri değiştirmez.

Uygulamalar, anahtarın olmasına nullizin verip vermediklerine göre değişiklik gösterebilir.

Ayrıca bkz.

• Item[Object]