IDictionary.Add-Methode

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

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Sub Add ( _
    key As Object, _
    value As Object _
)
'Usage
Dim instance As IDictionary
Dim key As Object
Dim value As Object

instance.Add(key, value)

void Add (
    Object key,
    Object value
)

void Add (
    Object^ key, 
    Object^ value
)

void Add (
    Object key, 
    Object value
)

function Add (
    key : Object, 
    value : Object
)

Parameter

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

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	key ist NULL (Nothing in Visual Basic).
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.

Hinweise

Sie können die Item-Eigenschaft auch zum Hinzufügen neuer Elemente verwenden, indem Sie den Wert eines Schlüssels festlegen, der im Wörterbuch nicht vorhanden ist, beispielsweise myCollection["myNonexistentKey"] = myValue. Wenn der angegebene Schlüssel jedoch bereits im Wörterbuch vorhanden ist, wird der alte Wert durch das Festlegen der Item-Eigenschaft überschrieben. Im Gegensatz dazu ändert die Add-Methode keine vorhandenen Elemente.

Implementierungen können sich dahingehend voneinander abweichen, ob Schlüssel NULL (Nothing in Visual Basic) sein dürfen.

Beispiel

Das folgende Codebeispiel veranschaulicht das Implementieren der Add-Methode. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die IDictionary-Klasse.

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

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:
    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);
    }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDictionary-Schnittstelle
IDictionary-Member
System.Collections-Namespace
Item