OrderedDictionary.Add(Object, Object) Метод

Определение

Пространство имен:
System.Collections.Specialized
Сборки:
System.dll, System.Collections.Specialized.dll
Сборки:
netstandard.dll, System.Collections.Specialized.dll
Сборка:
System.Collections.Specialized.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs

Добавляет запись с указанным ключом и значением в OrderedDictionary коллекцию с наименьшим доступным индексом.

public:
 virtual 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 -> unit
override this.Add : obj * obj -> unit
Public Sub Add (key As Object, value As Object)

Параметры

key
Object

Ключ добавляемой записи.

value
Object

Значение добавляемой записи. Это значение может быть равно null.

Реализации

Add(Object, Object)

Исключения

NotSupportedException

Коллекция OrderedDictionary доступна только для чтения.

ArgumentException

Элемент с тем же ключом уже существует в OrderedDictionary коллекции.

Примеры

В следующем примере кода показано создание и заполнение OrderedDictionary коллекции. Этот код является частью более крупного примера кода, который можно просмотреть по OrderedDictionaryадресу.

// Creates and initializes a OrderedDictionary.
OrderedDictionary myOrderedDictionary = new OrderedDictionary();
myOrderedDictionary.Add("testKey1", "testValue1");
myOrderedDictionary.Add("testKey2", "testValue2");
myOrderedDictionary.Add("keyToDelete", "valueToDelete");
myOrderedDictionary.Add("testKey3", "testValue3");

ICollection keyCollection = myOrderedDictionary.Keys;
ICollection valueCollection = myOrderedDictionary.Values;

// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);

' Creates and initializes a OrderedDictionary.
Dim myOrderedDictionary As New OrderedDictionary()
myOrderedDictionary.Add("testKey1", "testValue1")
myOrderedDictionary.Add("testKey2", "testValue2")
myOrderedDictionary.Add("keyToDelete", "valueToDelete")
myOrderedDictionary.Add("testKey3", "testValue3")

Dim keyCollection As ICollection = myOrderedDictionary.Keys
Dim valueCollection As ICollection = myOrderedDictionary.Values

' Display the contents Imports the key and value collections
DisplayContents( _
    keyCollection, valueCollection, myOrderedDictionary.Count)

Комментарии

Ключ не может быть null, но значение может быть.

Кроме того, свойство можно использовать Item[] для добавления новых элементов, задав значение ключа, который не существует в OrderedDictionary коллекции. Однако если указанный ключ уже существует в OrderedDictionaryобъекте, задав Item[] свойство перезаписывает старое значение. В отличие от Add этого, метод не изменяет существующие элементы, а вызывает ArgumentException.

Применяется к