При добавлении новых элементов в список емкость коллекции типа SortedList увеличивается автоматически по мере надобности. Так, если текущая емкость коллекции превышается, то она соответственно увеличивается. Преимущество указания емкости коллекции типа SortedList при ее создании заключается в снижении или полном исключении издержек на изменение размера коллекции. Разумеется, указывать емкость коллекции целесообразно лишь в том случае, если заранее известно, сколько элементов требуется хранить в ней.
В классе SortedList определяется ряд собственных методов, помимо тех, что уже объявлены в интерфейсах, которые в нем реализуются. Некоторые из наиболее часто используемых методов этого класса перечислены в табл. 25.6. Так, если требуется определить, содержится ли ключ в коллекции типа SortedList, вызывается метод Contains Key (). А если требуется выяснить, хранится ли конкретное значение в коллекции типа SortedList, вызывается метод ContainsValue (). Для перечисления содержимого коллекции типа SortedList служит метод GetEnumerator (), возвращающий объект типа IDict ionar yEnumerator. Напомним, что IDictionaryEnumerator — это перечислитель, используемый для перечисления содержимого коллекции, в которой хранятся пары "ключ-значение". И наконец, для получения синхронизированной оболочки, в которую заключается коллекция типа SortedList, вызывается метод Synchronized ().
Таблица 25.6. Наиболее часто используемые методы, определенные в классе SortedList
Метод
Описание
public virtual bool
Возвращает логическое значение true, если в
ContainsKey(object key)
вызывающей коллекции типа SortedList содер
жится ключ key, а иначе — логическое значение
false
Окончание табл. 25.6
Метод
Описание
public virtual bool
Возвращает логическое значение true, если в
ContainsValue(object value)
вызывающей коллекции типа SortedList со
держится значение value, а иначе — логическое значение false
public virtual object
Возвращает значение, указываемое по индексу
GetBylndex(int index)
index
public virtual
Возвращает для вызывающей коллек
IDictionaryEnumerator
ции типа SortedList перечислитель типа
GetEnumerator()
IDictionaryEnumerator
public virtual object
Возвращает значение ключа, указываемое по ин
GetKey(int index)
дексу index
public virtual IList
Возвращает коллекцию типа SortedList с клю
GetKeyList()
чами, хранящимися в вызывающей коллекции типа SortedList
public virtual IList
Возвращает коллекцию типа SortedList со зна
GetValueList()
чениями, хранящимися в вызывающей коллекции типа SortedList
public virtual int
Возвращает индекс ключа key. Если искомый
IndexOfKey(object key)
ключ не обнаружен, возвращается значение -1
public virtual int
Возвращает индекс первого вхождения значения
IndexOfValue(object value)
value в вызывающей коллекции. Если искомое значение не обнаружено, возвращается значение -1
public virtual void
Устанавливает значение по индексу index рав
SetBylndex(int index, object
ным значению value
value)
public static SortedList
Возвращает синхронизированный вариант коллек
Synchronized(SortedList list)
ции типа SortedList, передаваемой в качестве параметра list
public virtual void
Устанавливает значение свойства Capacity рав
TrimToSize()
ным значению свойства Count
Ключ или значение можно получить разными способами. В частности, для получения значения по указанному индексу служит метод GetBylndex (), а для установки значения по указанному индексу — метод SetBylndex (). Для извлечения ключа по указанному индексу вызывается метод Get Key (), а для получения списка ключей по указанному индексу — метод GetKeyList (). Кроме того, для получения списка всех значений из коллекции служит метод GetValueList(). Для получения индекса ключа вызывается метод IndexOfKey (), а для получения индекса значения — метод IndexOfValue (). Безусловно, в классе SortedList также поддерживается индексатор, определяемый в интерфейсе IDictionary и позволяющий устанавливать и получать значение по заданному ключу.