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

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

Метод

Описание

void Add(TKey key , TValue value\

bool Contains(TKey key)

bool Remove(TKey key)

bool TryGetValue(TKey key , out TValue value)

Добавляет в вызывающую коллекцию пару “ключ-значение”, определяемую параметрами key и value. Генерирует исключение ArgumentException,если ключ key уже находится в коллекции Возвращает логическое значение true,если вызывающая коллекция содержит элемент key в качестве ключа, а иначе — логическое значение falseУдаляет из коллекции элемент, ключ которого равен значению key

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

В интерфейсе IEnumerable метод GetEnumerator () объявляется следующим образом.

IEnumerator GetEnumerator()

Этот метод возвращает перечислитель типа Т для коллекции. А это означает, что он возвращает типизированный перечислитель.

Кроме того, в интерфейсе IEnumerable определяются два таких же метода, как и в необобщенном его варианте: MoveNext ( ) и Reset () . В этом интерфейсе объявляется также обобщенный вариант свойства Current.

Т Current { get; }

Это свойство возвращает ссылку типа Т на следующий объект. А это означает, что обобщенный вариант свойства Current является типизированным.

Но между интерфейсами IEnumerator и IEnumerator имеется одно важное различие: интерфейс IEnumerator наследует от интерфейса IDisposable, тогда как интерфейс IEnumerator не наследует от него. В интерфейсе IDisposable определяется метод Dispose () , который служит для освобождения неуправляемых ресурсов.

ПРИМЕЧАНИЕ

В интерфейсе lEnumerableреализуется также необобщенный интерфейс IEnumerable.Это означает, что в нем поддерживается необобщенный вариант метода GetEnumerator ().Кроме того, в интерфейсе lEnumerableреализуется необобщенный интерфейс IEnumerator,а следовательно, в нем поддерживаются необобщенные варианты свойства Current.

Интерфейс IComparer

Интерфейс IComparer<���Т> является обобщенным вариантом рассмотренного ранее интерфейса IComparer. Главное отличие между ними заключается в том, что интерфейс IComparer обеспечивает типовую безопасность. В нем обобщенный вариант метода Compare () объявляется следующим образом.

int Compare(Т х, Т у)

В этом методе сравниваются объекты х и у. Он возвращает положительное значение, если значение объекта х больше, чем у объекта у; отрицательное — если значение объекта х меньше, чем у объекта у; и нулевое значение — если сравниваемые значения равны.

Интерфейс IEqualityComparer

Интерфейс IEqualityComparer полностью соответствует своему необобщенному аналогу EqualityComparer. В нем определяются два следующих метода.

bool Equals(Т х, Т у) int GetHashCode(Т obj)

Метод Equals () должен возвратить логическое значение true, если значения объектов х и у равны. А метод GetHashCode () возвращает хеш-код для объекта obj. Если два сравниваемых объекта равны, то их хеш-коды также должны быть одинаковы.

Интерфейс ISet

Интерфейс ISet был добавлен в версию 4.0 среды .NET Framework. Он определяет поведение обобщенной коллекции, реализующей ряд уникальных элементов. Этот интерфейс наследует от интерфейсов IEnumerable, IEnumerable, а также ICollection. В интерфейсе ISet определен ряд методов, перечисленных в табл. 25.13. Обратите внимание на то, что параметры этих методов указываются как относящиеся к типуIEnumerable. Это означает, что в качестве второго аргумента методу можно передать нечто, отличающееся от объектов типаISet. Но чаще всего оба аргумента оказываются экземплярами объектов типаISet.

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

Метод

Описание

void ExceptWith(Ienumerable

Удаляет из вызывающего множества те элементы,

other)

которые содержатся в другом множестве other

void

После вызова этого метода вызывающее множе

IntersectWith(IEnumerable

ство содержит пересечение своих элементов с эле

other)

ментами другого множества other

bool

Возвращает логическое значение true,если вы

IsProperSubsetOf(IEnumerable

зывающее множество является правильным под

other)

множеством другого множества other , а иначе — логическое значение false