IDictionary.Add(Object, Object) Methode

Definitie

Naamruimte:
System.Collections
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Voegt een element met de opgegeven sleutel en waarde toe aan het 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)

Parameters

key
Object

De Object te gebruiken als sleutel van het element dat moet worden toegevoegd.

value
Object

De Object te gebruiken als de waarde van het element dat moet worden toegevoegd.

Uitzonderingen

ArgumentNullException

key is null.

ArgumentException

Er bestaat al een element met dezelfde sleutel in het IDictionary object.

NotSupportedException

Het IDictionary is alleen-lezen.

– of –

De IDictionary heeft een vaste grootte.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Add methode implementeert. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de IDictionary klasse.

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

Opmerkingen

U kunt de Item[] eigenschap ook gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet bestaat in de woordenlijst (bijvoorbeeld myCollection["myNonexistentKey"] = myValue). Als de opgegeven sleutel echter al bestaat in de woordenlijst, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen Add geen bestaande elementen.

Implementaties kunnen variëren in of ze de sleutel toestaan.null

Van toepassing op

Zie ook