Поделиться через


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

Определение

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

Реализации

Исключения

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

Элемент с таким ключом уже существует в коллекции 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.

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