Какие методы определяет ICollection?

Методы интерфейса ICollection<T>

Интерфейс ICollection<T> является ключевым интерфейсом в .NET, представляющим базовый контракт для всех коллекций элементов типа T. Он наследует от IEnumerable<T>, что гарантирует возможность перебора элементов, и добавляет методы для управления коллекцией: добавления, удаления, проверки наличия элементов и получения информации о размере.

Основные методы интерфейса

Основные методы, определяемые ICollection<T>:

1. Add(T item) - добавляет элемент в коллекцию.

   void Add(T item);
   

2. Remove(T item) - удаляет первый экземпляр указанного элемента из коллекции. Возвращает true, если элемент был успешно удален.

   bool Remove(T item);
   

3. Contains(T item) - проверяет, содержит ли коллекция указанный элемент. Возвращает true, если элемент найден.

   bool Contains(T item);
   

4. Clear() - удаляет все элементы из коллекции.

   void Clear();
   

5. CopyTo(T[] array, int arrayIndex) - копирует элементы коллекции в указанный массив, начиная с заданного индекса.

   void CopyTo(T[] array, int arrayIndex);
   

Свойства интерфейса

Кроме методов, ICollection<T> определяет три важных свойства:

• Count - возвращает количество элементов в коллекции.

  int Count { get; }
  

• IsReadOnly - указывает, является ли коллекция только для чтения. Если true, методы Add, Remove и Clear будут вызывать исключение.

  bool IsReadOnly { get; }
  

Пример использования ICollection<T>

Рассмотрим практический пример работы с ICollection<T> через один из его реализаций - List<T>:

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        ICollection<string> collection = new List<string>();
        
        // Добавление элементов
        collection.Add("Apple");
        collection.Add("Banana");
        collection.Add("Cherry");
        
        // Проверка количества
        Console.WriteLine($"Count: {collection.Count}");
        
        // Проверка наличия элемента
        bool hasBanana = collection.Contains("Banana");
        Console.WriteLine($"Contains 'Banana': {hasBanana}");
        
        // Удаление элемента
        bool removed = collection.Remove("Banana");
        Console.WriteLine($"Removed 'Banana': {removed}");
        Console.WriteLine($"Count after removal: {collection.Count}");
        
        // Копирование в массив
        string[] array = new string[collection.Count];
        collection.CopyTo(array, 0);
        Console.WriteLine("Copied array: " + string.Join(", ", array));
        
        // Очистка коллекции
        collection.Clear();
        Console.WriteLine($"Count after clear: {collection.Count}");
    }
}

Значение в архитектуре .NET

ICollection<T> служит фундаментальным интерфейсом для большинства коллекций в .NET:

• List<T>, Dictionary<TKey, TValue>, Queue<T>, Stack<T> и другие коллекции реализуют этот интерфейс.
• Он обеспечивает стандартизированный набор операций, что позволяет унифицировать работу с различными типами коллекций.
• Интерфейс поддерживает обобщенный подход (generics), что обеспечивает безопасность типов и исключает необходимость приведения типов.

Отличие от базового ICollection

Важно отметить существование необобщенного интерфейса ICollection (без <T>), который является частью более старой архитектуры .NET 1.x. Этот интерфейс определяет методы CopyTo(Array, int) и свойства Count, IsSynchronized, SyncRoot, но не включает методы Add, Remove, Contains и Clear. Обобщенный ICollection<T> является более современным и полным интерфейсом.

Практическое применение в разработке

При разработке собственных коллекций или структур данных реализация ICollection<T> обеспечивает:

• Интеграцию с существующими механизмами .NET (LINQ, сериализация, привязка данных).
• Совместимость с стандартными алгоритмами и библиотеками.
• Удобство для потребителей вашего API, которые могут использовать знакомые методы управления коллекцией.

Таким образом, ICollection<T> представляет собой критически важный интерфейс в системе типов .NET, обеспечивающий стандартный контракт для операций с коллекциями и являющийся основой для большинства структур данных в библиотеках C#.