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

Таблица 25.4. Наиболее часто используемые методы, определенные в классе ArrayList

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

public virtual void AddRange(Icollection с) public virtual int BinarySearch(object value) - Добавляет элементы из коллекции св конец вызывающей коллекции типа ArrayListВыполняет поиск в вызывающей коллекции значения value. Возвращает индекс найденного элемента. Если искомое значение не найдено, возвращает отрицательное значение. Вызывающий список должен быть отсортирован

public virtual int BinarySearcii (object value,- Icomparer comparer) - Выполняет поиск в вызывающей коллекции значения value , используя для сравнения способ, определяемый параметром comparer. Возвращает индекс совпавше го элемента. Если искомое значение не найдено, возвращает отрицательное значение. Вызывающий список должен быть отсортирован

public virtual int BinarySearch(int index, int count, object value, IComparer comparer) - Выполняет поиск в вызывающей коллекции значения value , используя для сравнения способ, определяемый параметром comparer. Поиск начинается с элемента, указываемого по индексу index , и включает количество элементов, определяемых параметром count. Метод возвращает индекс совпавшего элемента. Если искомое значение не найдено, метод возвращает отрицательное значение. Вызывающий список должен быть отсортирован

public virtual void CopyTo(Array array) - Копирует содержимое вызывающей коллекции в массив array, который должен быть одномерным и совместимым по типу с элементами коллекции

public virtual void CopyTo(Array array, int arraylndex) - Копирует содержимое вызывающей коллекции в массив array, начиная с элемента, указываемого по индексу arraylndex. Целевой массив должен быть одномерным и совместимым по типу с элементами коллекции

public virtual void CopyTo(int index, Array array, int arraylndex, int count) - Копирует часть вызывающей коллекции, начиная с элемента, указываемого по индексу index, и включая количество элементов, определяемых параметром count, в массив array, начиная с элемента, указываемого по индексу arraylndex. Целевой массив должен быть одномерным и совместимым по типу с элементами коллекции

public static ArrayList FixedSize(ArrayList list) - Заключает коллекцию list в оболочку типа ArrayListс фиксированным размером и возвращает результат

public virtual ArrayList GetRange(int index, int count) - Возвращает часть вызывающей коллекции типа ArrayList.Часть возвращаемой коллекции начинается с элемента, указываемого по индексу index, и включает количество элементов, определяемое параметром count. Возвращаемый объект ссылается на те же элементы, что и вызывающий объект

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

public virtual void InsertRange(int index, ICollection c) -Вставляет элементы коллекции св вызывающую коллекцию, начиная с элемента, указываемого по индексу index

public virtual int LastlndexOf(object value) - Возвращает индекс последнего вхождения объекта valueв вызывающей коллекции. Если искомый объект не обнаружен, метод возвращает значение -1

public static ArrayList Readonly(ArrayList list) - Заключает коллекцию list в оболочку типа ArrayList,доступную только для чтения, и возвращает результат

public virtual void RemoveRange(int index, int count) - Удаляет часть вызывающей коллекции, начиная с элемента, указываемого по индексу index , и включая количество элементов, определяемое параметром count

public virtual void Reverse() -Располагает элементы вызывающей коллекции в обратном порядке

public virtual void Reverse(int index, int count) - Располагает в обратном порядке часть вызывающей коллекции, начиная с элемента, указываемого по индексу index , и включая количество элементов, определяемое параметром count

public virtual void SetRange(int index, ICollection c) -Заменяет часть вызывающей коллекции, начиная с элемента, указываемого по индексу index,элементами коллекции с

public virtual void Sort() -Сортирует вызывающую коллекцию по нарастающей

public virtual void Sort(Icomparer comparer) - Сортирует вызывающую коллекцию, используя для сравнения способ, определяемый параметром comparer. Если параметр comparer имеет пустое значение, то для сравнения используется способ, выбираемый по умолчанию

public virtual void Sort(int index, int count, Icomparer comparer) - Сортирует вызывающую коллекцию, используя для сравнения способ, определяемый параметром comparer. Сортировка начинается с элемента, указываемого по индексу index , и включает количество элементов, определяемых параметром count. Если параметр comparerимеет пустое значение, то для сравнения используется способ, выбираемый по умолчанию

public static ArrayList Synchronized(ArrayList list) - Возвращает синхронизированный вариант коллекции типа ArrayList,передаваемой в качестве параметра list

public virtual object[] ToArray() -Возвращает массив, содержащий копии элементов вызывающего объекта

public virtual Array ToArray(Type type) - Возвращает массив, содержащий копии элементов вызывающего объекта. Тип элементов этого массива определяется параметром type

public virtual void TrimToSize() -Устанавливает значение свойства Capacityравным значению свойства Count

В классе ArrayListподдерживается также ряд методов, оперирующих элементами коллекции в заданных пределах. Так, в одну коллекцию типа ArrayListможно вставить другую коллекцию, вызвав метод InsertRange(). Для удаления из коллекции элементов в заданных пределах достаточно вызвать метод RemoveRange(). А для перезаписи элементов коллекции типа ArrayListв заданных пределах элементами из другой коллекции служит метод SetRange(). И наконец, элементы коллекции можно сортировать или искать в заданных пределах, а не во всей коллекции.

По умолчанию коллекция типа ArrayListне синхронизирована. Для получения синхронизированной оболочки, в которую заключается коллекция, вызывается метод Synchronized().

В классе ArrayListимеется также приведенное ниже свойство Capacity, помимо свойств, определенных в интерфейсах, которые в нем реализуются.

public virtual int Capacity { get; set; }

Свойство Capacityпозволяет получать и устанавливать емкость вызывающей коллекции типа ArrayList. Емкость обозначает количество элементов, которые может содержать коллекция типа ArrayListдо ее вынужденного расширения. Как упоминалось выше, коллекция типа ArrayListрасширяется автоматически, и поэтому задавать ее емкость вручную необязательно. Но из соображений эффективности это иногда можно сделать, если количество элементов коллекции известно заранее. Благодаря этому исключаются издержки на выделение дополнительной памяти.