PropertyCollection.IDictionary.Add(Object, Object) Metoda

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

PropertyCollection.cs

Přidá prvek se zadaným klíčem a hodnotou do objektu IDictionary .

 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

Parametry

key

Object

Použije Object se jako klíč elementu, který chcete přidat.

value

Object

Použije Object se jako hodnota prvku, který se má přidat.

Implementuje

Add(Object, Object)

Výjimky

ArgumentNullException

key je null.

ArgumentException

Prvek se stejným klíčem již v objektu IDictionary existuje.

NotSupportedException

Je IDictionary jen pro čtení.

-nebo-

Má IDictionary pevnou velikost.

Příklady

Následující příklad ukazuje, jak implementovat metodu Add . Tento příklad kódu je součástí většího příkladu IDictionary pro třídu .

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

Poznámky

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který ve slovníku neexistuje (například myCollection["myNonexistentKey"] = myValue). Pokud však zadaný klíč již ve slovníku existuje, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Viz také

• Item[Object]