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

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

Метод

Описание

public

int BinarySearch(T

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

item,

IComparer<T> comparer)

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

public

int BinarySearch(int

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

index,

int count, T item,

ния, задаваемого параметром item, используя для

IComparer<T> comparer)

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

public

List<T> GetRange(int

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

index,

int count)

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

public

int IndexOf(T item)

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

public

void InsertRange(int

Вставляет элементы коллекции collection в вы

index,

IEnumerable<T>

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

collection)

ваемого по индексу index

public i tern)

int LastlndexOf(T

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

public

void RemoveRange(int

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

index,

int count)

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

public

void Reverse()

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

public

void Reverse(int

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

index,

int count)

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

public

void Sort()

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

Окончание табл. 25.15

Метод

Описание

public void

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

Sort(IComparer<T> comparer)

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

public void

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

Sort (Comparison<T> comparison)

сравнения указанный делегат

public void Sort(int index,

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

int count, IComparer<T>

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

comparer)

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

public T [ ] ToArrayO

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

public void TrimExcess()

Сокращает емкость вызывающей коллекции таким образом, чтобы она не превышала 10% от количества элементов, хранящихся в ней на данный момент

В классе List<T> определяется также собственное свойство Capacity, помимо тех, что уже объявлены в интерфейсах, которые в нем реализуются. Это свойство объявляется следующим образом.

public int Capacity { get; set; }

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

В классе List<T> реализуется также приведенный ниже индексатор, определенный в интерфейсе IList<T>.

public Т this[int index] { get; set; }

С помощью этого индексатора устанавливается и получается значение элемента коллекции, указываемое по индексу index.

В приведенном ниже примере программы демонстрируется применение класса List<T>. Это измененный вариант примера, демонстрировавшего ранее класс ArrayList. Единственное изменение, которое потребовалось для