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

Определение

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

System.Collections.Specialized

Сборка:

System.Collections.Specialized.dll

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

OrderedDictionary.cs

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

public:
 virtual void Add(System::Object ^ key, System::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.