IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) Method

Definition

Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu.Adds an element with the provided key and value to the IDictionary object.

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)

Parameter

key
Object Object Object Object

Das Object, das als Schlüssel für das hinzuzufügende Element verwendet werden soll.The Object to use as the key of the element to add.

value
Object Object Object Object

Das Object, das als Wert für das hinzuzufügende Element verwendet werden soll.The Object to use as the value of the element to add.

Ausnahmen

Ein Element mit demselben Schlüssel ist im IDictionary-Objekt bereits vorhanden.An element with the same key already exists in the IDictionary object.

IDictionary ist schreibgeschützt.The IDictionary is read-only.

- oder --or- IDictionary hat eine feste Größe.The IDictionary has a fixed size.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie zum Implementieren der Add Methode.The following code example demonstrates how to implement the Add method. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die IDictionary Klasse.This code example is part of a larger example provided for the IDictionary class.

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

Hinweise

Sie können auch die Item[Object] Eigenschaft, um neue Elemente hinzufügen, indem dem Wert eines Schlüssels, der im Wörterbuch nicht vorhanden (z. B. myCollection["myNonexistentKey"] = myValue).You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the dictionary (for example, myCollection["myNonexistentKey"] = myValue). Aber wenn es sich bei der angegebene Schlüssel im Wörterbuch bereits vorhanden ist, Festlegen der Item[Object] Eigenschaft überschreibt den alten Wert.However, if the specified key already exists in the dictionary, setting the Item[Object] property overwrites the old value. Im Gegensatz dazu die Add Methode vorhandene Elemente nicht geändert.In contrast, the Add method does not modify existing elements.

Implementierungen können je nach, ob sie den Schlüssel, ermöglichen null.Implementations can vary in whether they allow the key to be null.

Gilt für:

Siehe auch