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

Enumerator - Предоставляет методы, позволяющие получать содержимое коллекции по очереди

IEqualityComparer -Сравнивает два объекта на предмет равенства

IList -Определяет обобщенную коллекцию, доступ к которой можно получить с помощью индексатора

В интерфейсе ICollectionопределен ряд свойств, которые являются общими для всех обобщенных коллекций. Интерфейс ICollectionявляется обобщенным вариантом необобщенного интерфейса ICollection, хотя между ними имеются некоторые отличия.

Итак, в интерфейсе ICollectionопределены следующие свойства.

int Count { get; }

bool IsReadOnly { get; }

Свойство Countсодержит ряд элементов, хранящихся в данный момент в коллекции. А свойство IsReadOnlyимеет логическое значение true, если коллекция доступна только для чтения. Если же коллекция доступна как для чтения, так и для записи, то данное свойство имеет логическое значение false.

Кроме того, в интерфейсе ICollectionопределены перечисленные ниже методы. Обратите внимание на то, что в этом обобщенном интерфейсе определено несколько большее количество методов, чем в его необобщенном аналоге.

Метод -Описание

void Add(T item) - Добавляет элемент item в вызывающую коллекцию. Генерирует исключение NotSupportedException,если коллекция доступна только для чтения

void Clear() -Удаляет все элементы из вызывающей коллекции

bool Contains(T item) - Возвращает логическое значение true,если вызывающая коллекция содержит элемент item , а иначе — логическое значение false

void CopyTo(T[] array, int arraylndex) - Копирует содержимое вызывающей коллекции в массив array , начиная с элемента, указываемого по индексу arraylndex

void Remove(T item) - Удаляет первое вхождение элемента item в вызывающей коллекции. Возвращает логическое значение true,если элемент i tem удален. А если этот элемент не найден в вызывающей коллекции, то возвращается логическое значение false

Некоторые из перечисленных выше методов генерируют исключение NotSupportedException, если коллекция доступна только для чтения.

А поскольку интерфейс ICollectionнаследует от интерфейсов IEnumerableи IEnumerable, то он включает в себя также обобщенную и необобщенную формы метода GetEnumerator().

Благодаря тому что в интерфейсе ICollectionреализуется интерфейс IEnumerable, в нем поддерживаются также методы расширения, определенные в классе Enumerable. Несмотря на то что методы расширения предназначены главным образом для поддержки LINQ, им можно найти и другое применение, в том числе и в коллекциях.

В интерфейсе IListопределяется такое поведение обобщенной коллекции, которое позволяет осуществлять доступ к ее элементам по индексу с отсчетом от нуля. Этот интерфейс наследует от интерфейсов IEnumerable, IEnumerableи ICollectionи поэтому является обобщенным вариантом необобщенного интерфейса IList. Методы, определенные в интерфейсе IList, перечислены в табл. 25.11. В двух из этих методов предусматривается модификация коллекции. Если же коллекция доступна только для чтения или имеет фиксированный размер, то методы Insert()и RemoveAt()генерируют исключение NotSupportedException.

Таблица 25.11. Методы, определенные в интерфейсе IList

Метод -Описание

int IndexOf(Т item) - Возвращает индекс первого вхождения элемента item в вызывающей коллекции. Если элемент item не обнаружен, то метод возвращает значение -1

void Insert(int index, T item) - Вставляет в вызывающую коллекцию элемент item по индексу index

void RemoveAt(int index) - Удаляет из вызывающей коллекции элемент, расположенный по указанному индексу index

Кроме того, в интерфейсе IListопределяется индексатор

Т this[int index] { get; set; }

который устанавливает или возвращает значение элемента коллекции по указанному индексу index.

В интерфейсе IDictionary определяется такое поведение обобщенной коллекции, которое позволяет преобразовать уникальные ключи в соответствующие значения. Это означает, что в данном интерфейсе определяется коллекция, в которой хранятся пары "ключ-значение". Интерфейс IDictionary наследует от интерфейсов IEnumerable, IEnumerable> и ICollection> и поэтому является обобщенным вариантом необобщенного интерфейса IDictionary. Методы, объявленные в интерфейсе IDictionary, приведены в табл. 25.12. Все эти методы генерируют исключение ArgumentNullException при попытке указать пустой ключ.

Таблица 25.12. Методы, определенные в интерфейсе IDictionaryCTKey, TValue>

Метод - Описание

void Add(TKey key , TValue value) - Добавляет в вызывающую коллекцию пару “ключ-значение”, определяемую параметрами key и value. Генерирует исключение ArgumentException,если ключ key уже находится в коллекции

bool Contains(TKey key) - Возвращает логическое значение true,если вызывающая коллекция содержит элемент key в качестве ключа, а иначе — логическое значение false

bool Remove(TKey key) - Удаляет из коллекции элемент, ключ которого равен значению key

bool TryGetValue(TKey key , out TValue value) - Предпринимает попытку извлечь значение из коллекции по указанному ключу key и присвоить это значение переменной value. При удачном исходе операции возвращается логическое значение true,а иначе — логическое значение false.Если ключ key не найден, переменной value присваивается значение, выбираемое по умолчанию

Кроме того, в интерфейсе IDictionaryопределены перечисленные ниже свойства.

Свойство- Описание

ICollection Keys { get; }Подучает коллекцию ключей

ICollection Values { get; }Получает коллекцию значений

Следует иметь в виду, что ключи и значения, содержащиеся в коллекции, доступны отдельными списками с помощью свойств Keysи Values.

И наконец, в интерфейсе IDictionaryопределяется следующий индексатор.

TValue this[TKey key ] { get; set; }

Этот индексатор служит для получения и установки значения элемента коллекции, а также для добавления в коллекцию нового элемента. Следует, однако, иметь в виду, что в качестве индекса в данном случае служит ключ элемента, а не сам индекс.

Интерфейсы IEnumerableи IEnumeratorявляются обобщенными эквивалентами рассмотренных ранее необобщенных интерфейсов IEnumerableи IEnumerator. В них объявляются аналогичные методы и свойства, да и действуют они по тому же принципу. Разумеется, обобщенные интерфейсы оперируют данными только того типа, который указывается в аргументе типа.