PropertyCollection.IDictionary.Add(Object, Object) Methode

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Quelle:

PropertyCollection.cs

Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu.

 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

Das Object, das als Schlüssel für das hinzuzufügende Element verwendet werden soll.

value

Object

Das Object, das als Wert für das hinzuzufügende Element verwendet werden soll.

Implementiert

Add(Object, Object)

Ausnahmen

ArgumentNullException

key ist null.

ArgumentException

Ein Element mit demselben Schlüssel ist im IDictionary-Objekt bereits vorhanden.

NotSupportedException

IDictionary ist schreibgeschützt.

- oder -

IDictionary hat eine feste Größe.

Beispiele

Im folgenden Beispiel wird die Implementierung der Add-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die IDictionary-Klasse bereitgestellt wird.

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 die Item[] -Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, myCollection["myNonexistentKey"] = myValueder im Wörterbuch nicht vorhanden ist (z. B. ). Wenn der angegebene Schlüssel jedoch bereits im Wörterbuch vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode vorhandene Elemente nicht.

Weitere Informationen

• Item[Object]