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

Таблица 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 следующим образом.

public virtual ICollection Keys { get; } public virtual ICollection Values { get; }

Порядок следования ключей и значений отражает порядок их расположения в коллекции типа SortedList.

Аналогично коллекции типа Hashtable, пары "ключ-значение" сохраняются в коллекции типа SortedList в форме структуры типа DictionaryEntry, но, как правило, доступ к ключам и значениям осуществляется по отдельности с помощью методов и свойств, определенных в классе SortedList.

В приведенном ниже примере программы демонстрируется применение класса SortedList. Это переработанный и расширенный вариант предыдущего примера, демонстрировавшего применение класса Hashtable, вместо которого теперь используется класс SortedList. Глядя на результат выполнения этой программы, вы можете сами убедиться, что теперь список полученных значений оказывается отсортированным по заданному ключу.