IDictionary.Add(Object, Object) Yöntem

public:
 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

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

Parametreler

Özel durumlar

Ö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.

Şunlara uygulanır

Ayrıca bkz.

• Item[Object]