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

Определение

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

System.Collections.Specialized

Сборки:

System.dll, System.Collections.Specialized.dll

Сборка:

System.Collections.Specialized.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Добавляет запись с указанным ключом и значением в коллекцию 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 = gcnew 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.
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.