PropertyCollection.IDictionary.Add(Object, Object) Метод

Определение

Пространство имен:

System.DirectoryServices

Сборка:

System.DirectoryServices.dll

Пакет:

System.DirectoryServices v8.0.0

Исходный код:

PropertyCollection.cs

Добавляет элемент с указанными ключом и значением в объект 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

Параметры

key

Object

Объект Object используется в качестве ключа добавляемого элемента.

value

Object

Объект Object используется в качестве значения добавляемого элемента.

Реализации

Add(Object, Object)

Исключения

ArgumentNullException

key имеет значение null.

ArgumentException

Элемент с таким ключом уже существует в объекте IDictionary.

NotSupportedException

Объект IDictionary доступен только для чтения.

-или-

IDictionary имеет фиксированный размер.

Примеры

В следующем примере показана реализация метода Add. Этот пример входит в состав более крупного примера использования класса IDictionary.

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

Комментарии

Свойство также можно использовать для Item[] добавления новых элементов, задав значение ключа, не существующего в словаре (например, myCollection["myNonexistentKey"] = myValue). Однако если указанный ключ уже существует в словаре, установка Item[] свойства перезаписывает старое значение. В отличие от этого, Add метод не изменяет существующие элементы.

См. также раздел

• Item[Object]