Призначення класу ArrayList — втілює інтерфейс IList за допомогою масиву з динамічною зміною розміру.

Загальне уявлення про створення представника класу ArrayList можна отримати, переглянувши код програми та проаналізу­вавши її виведенням.

У поданому далі описі у дужках () вказано тип параметра.

Зауваження

• Не рекомендують використовувати клас ArrayList для нової розробки. Натомість рекомендують використовувати універсальний клас List. Клас ArrayList призначено для зберігання різноманітних колекцій об'єктів. Але він не завжди забезпечує кращу продуктивність. Натомість рекомендують наступне:

  • для різнорідної колекції об'єктів використовувати клас List<Object>;
  • для однорідної колекції об'єктів використовувати клас List<T> клас.

• Упорядкування ArrayList не гарантовано. Необхідно відсортувати ArrayList, викликавши його метод Sort, перед виконанням деяких операцій (наприклад, BinarySearch). Щоб зберегти колекцію, яка автоматично відсортована при додаванні нових елементів, можна використовувати клас SortedSet.

• Місткість ArrayList — це кількість елементів, які можуть бути в об'єкті ArrayList. При додаванні елементів в ArrayList місткість автоматично збільшується при необхідності шляхом перерозподілу пам'яті. Місткість можна зменшити шляхом виклику TrimToSize або явного Capacity завдання властивості.

• Лише для платформи .NET Framework. Для великих об'єктів ArrayList можна збільшити максимальну ємність до 2 мільярдів елементів в 64-розрядній системі, надавши значення true enabled атрибуту елемента конфігурації gcAllowVeryLargeObjects у середовищі середовища виконання.

• Доступ до елементів можна отримати за допомогою цілочисельного індексу. Індекси у цій колекції відраховуються від нуля.

• 3 Колекція ArrayList приймає null як допустиме значення. Вона також дає змогу дублювати елементи.

• Використання багатовимірних масивів як елементів ArrayList колекції не підтримано.

• ArrayList() — ініціалізує порожній представник класу з початковою ємністю як усталено.
• ArrayList(ICollection) — ініціалізує представник класу, який містить елементи вказаної колекції і має початкову ємність, що дорівнює кількості скопійованих елементів.
• ArrayList(Int32) — ініціалізує порожній представник класу з указаною початковою ємністю.

• Capacity — ємність — кількість елементів, які може містити список.
• Count — фактична кількість елементів списку.
• IsFixedSize — true, якщо список має фіксований розмір, інакше — false.
• IsReadOnly — true, якщо список доступний лише для читання, інакше — false.
• IsSynchronized — true, якщо доступ до списку синхронізовано (список потокобезпечний).
• Item[Int32] — повертає або задає елемент за вказаним індексом.
• SyncRoot — об'єкт, за допомогою якого можна синхронізувати доступ до колекції.

Методи

• Adapter(IList) — створює оболонку для інтерфейсу IList.
• Add(Object) — додає об'єкт до кінця колекції ArrayList.
• AddRange(ICollection) — додає елементи інтерфейсу ICollection до кінця списку.
• BinarySearch(Int32, Int32, Object, IComparer) — виконує пошук елемента в указаному діапазоні значень індексів елементів упорядкованого списку, використовуючи вказану функцію порівняння, та повертає індекс елемента, відрахований від нуля.
• BinarySearch(Object) — виконує пошук елемента по всьому упорядкованому списку, використовуючи порівнювач як усталено, і повертає індекс елемента, відрахований від нуля.
• BinarySearch(Object, IComparer) — виконує пошук елемента по всьому упорядкованому списку, використовуючи вказаний компаратор, та повертає індекс елемента, що відраховується від нуля.
• Clear() — видаляє з колекції усі елементи.
• Clone() — створює копію поточної колекції.
• Contains(Object) — повертає true, якщо список містить указаний елемент. Інакше повертає false..
• CopyTo(Array) — копіює весь список у вказаний одновимірний масив, починаючи з початкового елемента цільового масиву.
• CopyTo(Array, Int32) — копіює весь список у вказаний масив, починаючи з указаного індексу цільового масиву.
• CopyTo(Int32, Array, Int32, Int32) — копіює діапазон елементів зі списку в указаний одновимірний масив, починаючи з указаного індексу цільового масиву.
• Equals(Object) — повертає true, якщо вказаний об'єкт дорівнює поточному. Інакше повертає false (успадковано від Object).
• FixedSize(ArrayList) — повертає оболонку ArrayList фіксованого розміру.
• FixedSize(IList) — повертає оболонку IList фіксованого розміру.
• GetEnumerator() — повертає перечислювач списку.
• GetEnumerator(Int32, Int32) — повертає перечислювач для діапазону елементів списку.
• GetHashCode() — хеш-функція як усталено (успадковано від Object).
• GetRange(Int32, Int32) — повертає список елементів поточного списку з указаного діапазону.
• GetType() — повертає об'єкт Type для поточного представника класу (успадковано від Object).
• IndexOf(Object) — здійснює пошук указаного об'єкта й повертає індекс першого входження в колекцію, рахуючи від нуля.
• IndexOf(Object, Int32) — здійснює пошук указаного об'єкта й повертає індекс першого входження в діапазоні елементів списку, рахуючи з нуля і починаючи з указаного індексу й до останнього елемента.
• IndexOf(Object, Int32, Int32) — виконує пошук указаного об'єкта й повертає індекс першого входження в діапазоні елементів списку, який починається із заданого індексу і містить вказану кількість елементів.
• Insert(Int32, Object) — вставляє елемент у список за вказаним індексом.
• InsertRange(Int32, ICollection) — вставляє елементи колекції до списку у позиції з указаним індексом.
• LastIndexOf(Object) — здійснює пошук указаного об'єкта й повертає індекс останнього входження в колекцію ArrayList, що відраховують від нуля.
• LastIndexOf(Object, Int32) — здійснює пошук указаного об'єкта й повертає індекс останнього входження в діапазоні елементів списку, що відраховують від нуля, починаючи з першого елемента і закінчуючи елементом з указаним індексом.
• LastIndexOf(Object, Int32, Int32) — виконує пошук указаного об'єкта й повертає індекс останнього входження в діапазоні елементів списку, що відраховують від нуля, який містить указану кількість елементів і закінчується в позиції з указаним індексом.
• MemberwiseClone() — створює неповну копію об'єкта Object (успадковано від Object).
• ReadOnly(ArrayList) — повертає програму-оболонку ArrayList, доступну лише для читання.
• ReadOnly(IList) — повертає програму-оболонку IList, доступну лише читання.
• Remove(Object) — видаляє перше входження вказаного об'єкта з колекції ArrayList.
• RemoveAt(Int32) — видаляє елемент списку з указаним індексом.
• RemoveRange(Int32, Int32) — видаляє діапазон елементів зі списку.
• Repeat(Object, Int32) — повертає список, елементи якого є копіями вказаного значення.
• Reverse() — змінює порядок елементів у списку на зворотний.
• Reverse(Int32, Int32) — змінює порядок елементів у вказаному діапазоні на зворотний.
• SetRange(Int32, ICollection) — копіює елементи колекції в діапазоні елементів списку ArrayList.
• Sort() — упорядковує елементи всього списку за зростанням.
• Sort(IComparer) — упорядовує елементи всього списку за допомогою вказаної функції порівняння.
• Sort(Int32, Int32, IComparer) — упорядковує елементи діапазону списку за допомогою вказаної функції порівняння.
• Synchronized(ArrayList) — повертає синхронізовану (потокобезпечну) оболонку ArrayList.
• Synchronized(IList) — повертає синхронізовану (потокобезпечну) оболонку IList.
• ToArray() — копіює елементи списку у новий масив об'єктів.
• ToArray(Type) — копіює елементи списку в новий масив з елементами вказаного типу.
• ToString() — повертає рядок, що становить поточний об'єкт (успадковано від Object).
• TrimToSize() — задає значення ємності, що дорівнює наявній кількості елементів списку.

Додаткові дані про явні втілення інтерфейсу, методи розширення потоко-безпечність подано на сторінці сайту learn.microsoft.com.