IDictionary.Add(Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет элемент с предоставленным ключом и значением в IDictionary объект.
public:
void Add(System::Object ^ key, System::Object ^ value);public void Add(object key, object value);public void Add(object key, object? value);abstract member Add : obj * obj -> unitPublic Sub Add (key As Object, value As Object)Параметры
Исключения
key равно null.
Элемент с тем же ключом уже существует в объекте IDictionary .
Примеры
В следующем примере кода показано, как реализовать Add метод. Этот пример кода является частью более крупного примера, предоставленного для IDictionary класса.
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 метод не изменяет существующие элементы.
Реализации могут различаться в том, разрешают ли они ключу быть null.
