Public ArrayList(ICollection с)

public ArrayList(int capacity)

Первый конструктор создает пустую коллекцию класса ArrayList с нулевой первоначальной емкостью. Второй конструктор создает коллекцию типа ArrayList с количеством инициализируемых элементов, которое определяется параметром с и равно первоначальной емкости массива. Третий конструктор создает коллекцию, имеющую указанную первоначальную емкость, определяемую параметром capaci ty. В данном случае емкость обозначает размер базового массива, используемого для хранения элементов коллекции. Емкость коллекции типа ArrayList может увеличиваться автоматически по мере добавления в нее элементов.

В классе ArrayList определяется ряд собственных методов, помимо тех, что уже объявлены в интерфейсах, которые в нем реализуются. Некоторые из наиболее часто используемых методов класса ArrayList перечислены в табл. 25.4. Коллекцию класса ArrayList можно отсортировать, вызвав метод Sort (). В этом случае поиск в отсортированной коллекции с помощью метода BinarySearch () становится еще более эффективным. Содержимое коллекции типа ArrayList можно также обратить, вызвав метод Reverse ().

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

 

Метод

 

Описание

 

public virtual void AddRange(Icollection с) public virtual int BinarySearch(object value)

 

Добавляет элементы из коллекции с в конец вызывающей коллекции типа ArrayList Выполняет поиск в вызывающей коллекции значения value. Возвращает индекс найденного элемента. Если искомое значение не найдено, возвращает отрицательное значение. Вызывающий список должен быть отсортирован

 

_ Продолжение табл. 25.4

 

Метод

 

Описание

 

Public virtual int

 

Выполняет поиск в вызывающей коллекции значения

 

BinarySearcii (object

 

value, используя для сравнения способ, определяемый

 

value,- Icomparer

 

параметром comparer. Возвращает индекс совпавше

 

comparer)

 

го элемента. Если искомое значение не найдено, возвращает отрицательное значение. Вызывающий список должен быть отсортирован

 

Public virtual int

 

Выполняет поиск в вызывающей коллекции значения

 

BinarySearch(int index,

 

value, используя для сравнения способ, определяемый

 

int count, object value,

 

параметром comparer. Поиск начинается с элемента,

 

IComparer comparer)

 

указываемого по индексу index, и включает количество элементов, определяемых параметром count. Метод возвращает индекс совпавшего элемента. Если искомое значение не найдено, метод возвращает отрицательное значение. Вызывающий список должен быть отсортирован

 

Public virtual void

 

Копирует содержимое вызывающей коллекции в мас

 

CopyTo(Array array)

 

сив array, который должен быть одномерным и совместимым по типу с элементами коллекции

 

Public virtual void

 

Копирует содержимое вызывающей коллекции в массив

 

CopyTo(Array array, int

 

array, начиная с элемента, указываемого по индексу

 

arraylndex)

 

arraylndex. Целевой массив должен быть одномерным и совместимым по типу с элементами коллекции

 

Public virtual void

 

Копирует часть вызывающей коллекции, начиная с эле

 

CopyTo(int index, Array

 

мента, указываемого по индексу index, и включая ко

 

array, int arraylndex,

 

личество элементов, определяемых параметром count,

 

int count)

 

в массив array, начиная с элемента, указываемого по индексу arraylndex. Целевой массив должен быть одномерным и совместимым по типу с элементами коллекции

 

Public static ArrayList

 

Заключает коллекцию list в оболочку типа ArrayList

 

FixedSize(ArrayList list)

 

с фиксированным размером и возвращает результат

 

Public virtual ArrayList

 

Возвращает часть вызывающей коллекции типа

 

GetRange(int index, int

 

ArrayList. Часть возвращаемой коллекции начинает

 

count)

 

ся с элемента, указываемого по индексу index, и включает количество элементов, определяемое параметром count. Возвращаемый объект ссылается на те же элементы, что и вызывающий объект

 

Public virtual int

 

Возвращает индекс первого вхождения объекта value

 

IndexOf(object value)

 

в вызывающей коллекции. Если искомый объект не обнаружен, возвращает значение -1

 

Public virtual void

 

Вставляет элементы коллекции с в вызывающую кол

 

InsertRange(int index,

 

лекцию, начиная с элемента, указываемого по индексу

 

ICollection c)

 

index

 

Public virtual int

 

Возвращает индекс последнего вхождения объекта

 

LastlndexOf(object value)

 

value в вызывающей коллекции. Если искомый объект не обнаружен, метод возвращает значение -1

 

Метод

 

Описание

 

Public static ArrayList

 

Заключает коллекцию list в оболочку типа

 

Readonly(ArrayList list)

 

ArrayList, доступную только для чтения, и возвращает результат

 

Public virtual void

 

Удаляет часть вызывающей коллекции, начиная с эле

 

RemoveRange(int index,

 

мента, указываемого по индексу index, и включая

 

int count)

 

количество элементов, определяемое параметром

count

 

Public virtual void

 

Располагает элементы вызывающей коллекции в обрат

 

Reverse()

 

ном порядке

 

Public virtual void

 

Располагает в обратном порядке часть вызывающей

 

Reverse(int index, int

 

коллекции, начиная с элемента, указываемого по индек

 

count)

 

су index, и включая количество элементов, определяемое параметром count

 

Public virtual void

 

Заменяет часть вызывающей коллекции, начиная с эле

 

SetRange(int index,

 

мента, указываемого по индексу index, элементами

 

ICollection c)

 

коллекции с

 

Public virtual void

 

Сортирует вызывающую коллекцию по нарастающей

 

Sort ()

 

Public virtual void

 

Сортирует вызывающую коллекцию, используя для срав

 

Sort(Icomparer comparer)

 

нения способ, определяемый параметром comparer. Если параметр comparer имеет пустое значение, то для сравнения используется способ, выбираемый по умолчанию

 

Public virtual void

 

Сортирует вызывающую коллекцию, используя для срав

 

Sort(int index, int

 

нения способ, определяемый параметром comparer.

 

count, Icomparer

 

Сортировка начинается с элемента, указываемого по

 

comparer)

 

индексу index, и включает количество элементов, определяемых параметром count. Если параметр comparer имеет пустое значение, то для сравнения используется способ, выбираемый по умолчанию

 

Public static ArrayList

 

Возвращает синхронизированный вариант коллекции

 

Synchronized(ArrayList

 

типа ArrayList, передаваемой в качестве параметра

 

list)

 

list

 

public virtual object[]

 

Возвращает массив, содержащий копии элементов вы

 

ToArray()

 

зывающего объекта

 

Public virtual Array

 

Возвращает массив, содержащий копии элементов вы

 

ToArray(Type type)

 

зывающего объекта. Тип элементов этого массива определяется параметром type

 

Public virtual void

 

Устанавливает значение свойства Capacity равным

 

TrimToSize()

 

значению свойства Count

 

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

Перезаписи элементов коллекции типа ArrayList в заданных пределах элементами из другой коллекции служит метод Set Range (). И наконец, элементы коллекции можно сортировать или искать в заданных пределах, а не во всей коллекции.