PropertyCollection.IDictionary.Add(Object, Object) Metod

Definition

Namnområde:
System.DirectoryServices
Sammansättning:
System.DirectoryServices.dll

Lägger till ett element med den angivna nyckeln och värdet i IDictionary objektet.

 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

Parametrar

key
Object

Att Object använda som nyckel för det element som ska läggas till.

value
Object

Att Object använda som värde för elementet som ska läggas till.

Implementeringar

Add(Object, Object)

Undantag

ArgumentNullException

key är null.

ArgumentException

Det finns redan ett element med samma nyckel i objektet IDictionary .

NotSupportedException

Är IDictionary skrivskyddad.

-eller-

Har IDictionary en fast storlek.

Exempel

I följande exempel visas hur du implementerar Add metoden. Det här kodexemplet är en del av ett större exempel för IDictionary klassen.

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

Kommentarer

Du kan också använda Item[] egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i ordlistan (till exempel myCollection["myNonexistentKey"] = myValue). Men om den angivna nyckeln redan finns i ordlistan skriver egenskapen Item[] över det gamla värdet. Metoden ändrar däremot Add inte befintliga element.

Gäller för

Se även