C# 4.0 полное руководство - 2011

При добавлении новых элементов в список емкость коллекции типа 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 и позволяющий устанавливать и получать значение по заданному ключу.

В классе SortedList доступны также открытые свойства, определенные в тех интерфейсах, которые в нем реализуются. Как и в классе Hashtable, в данном классе особая роль принадлежит двум свойствам, Keys и Values, поскольку с их помощью можно получить доступную только для чтения коллекцию ключей или значений из

коллекции типа SortedList. Эти свойства определяются в интерфейсе IDictionary следующим образом.