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

личество элементов, определяемых параметром 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 (). И наконец, элементы коллекции можно сортировать или искать в заданных пределах, а не во всей коллекции.

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

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

public virtual int Capacity { get; set; }

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

С другой стороны, если требуется сократить размер базового массива коллекции типа ArrayList, то для этой цели достаточно установить меньшее значение свойства Capacity. Но это значение не должно быть меньше значения свойства Count. Напомним, что свойство Count определено в интерфейсе ICollection и содержит количество объектов, хранящихся в коллекции на данный момент. Всякая попытка установить значение свойства Capacity меньше значения свойства Count приводит к генерированию исключения ArgumentOutOfRangeException. Поэтому для получения такого количества элементов коллекции типа ArrayList, которое содержится в ней на данный момент, следует установить значение свойства Capacity равным значению свойства Count. Для этой цели можно также вызвать метод TrimToSize ().

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

// Продемонстрировать применение класса ArrayList.

using System;

using System.Collections;

class ArrayListDemo { static void Main() {

// Создать коллекцию в виде динамического массива.

ArrayList al = new ArrayList ();

Console.WriteLine("Исходное количество элементов: " + al.Count);

Console.WriteLine();

Console.WriteLine("Добавить 6 элементов");

// Добавить элементы в динамический массив.

al.Add('С');

al.Add('А'); al.Add('E') ; al.Add(1В1) ; al.Add('D') ; al.Add(1F') ;

Console.WriteLine("Количество элементов: " + al.Count);

// Отобразить содержимое динамического массива,

// используя индексирование массива.

Console.Write("Текущее содержимое: "); for(int i=0; i < al.Count; i++)

Console.Write (al[i] + " ");

Console.WriteLine("\n");

Console.WriteLine("Удалить 2 элемента");

// Удалить элементы из динамического массива, al.Remove('F'); al.Remove('A');