PropertyCollection.IDictionary.Add(Object, Object) Methode

Definitie

Naamruimte:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll

Voegt een element met de opgegeven sleutel en waarde toe aan het IDictionary object.

 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

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.

Implementeringen

Add(Object, Object)

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

Van toepassing op

Zie ook