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

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; }Получает коллекцию значений