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

Добавляет элементы из коллекции collection в конец вызывающей коллекции типа ArrayList

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

Метод

Описание

public

int BinarySearch(T

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

item,

IComparer comparer)

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

public

int BinarySearch(int

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

index,

int count, T item,

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

IComparer comparer)

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

public

List GetRange(int

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

index,

int count)

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

public

int IndexOf(T item)

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

public

void InsertRange(int

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

index,

IEnumerable

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

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 comparer)

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

public void

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

Sort(Comparison comparison)

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

public void Sort(int index,

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

int count , IComparer

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

comparer)

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

public T [ ] ToArrayO

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

public void TrimExcess()

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

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

public int Capacity { get; set; }

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

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

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

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

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

// Продемонстрировать применение класса List. using System;

using System.Collections.Generic;

class GenListDemo { static void Main() {

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

List 1st = new List();

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

Console.WriteLine();

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

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

1st.Add('С');

1st.Add( 1А *);

1st.Add('Е');

1st.Add( 1В 1);

1st.Add('D');

1st.Add('F');

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