IOrderedDictionary.Insert Method (Int32, Object, Object)
Inserts a key/value pair into the collection at the specified index.
Assembly: System (in System.dll)
index is less than 0.
index is greater than Count.
key is null.
An element with the same key already exists in the IOrderedDictionary collection.
IOrderedDictionary accepts null as a valid value and allows duplicate elements.
In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. If the collection is indexed, the indexes of the elements that are moved are also updated. This behavior does not apply to collections where elements are conceptually grouped together, such as a hash table.
The following code example demonstrates the implementation of a simple IOrderedDictionary based on the ArrayList class. The implemented IOrderedDictionary stores first names as the keys and last names as the values, with the added requirement that each first name is unique. This code is part of a larger code example provided for the IOrderedDictionary class.
Available since 10
Available since 2.0