Призначення класу List — доступ до елементів за значенням індекса.

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

У поданому далі описі:

• T — тип значення елементів списку List;
• у дужках () чи <> вказано тип параметра.

Зауваження

• Клас List<T> є універсальним еквівалентом класу ArrayList. Він втілює універсальний інтерфейс IList<T> за допомогою масиву, розмір якого динамічно збільшується при необхідності.

• Засіб порівняння рівності як усталено типу T буде визначено таким чином. Якщо тип T втілює універсальний інтерфейс IEquatable<T>, засіб порівняння на рівність є методом Equals(T) цього інтерфейсу. Інакше буде використано Object.Equals (Object).

• Засіб порівняння щодо упорядкування як усталено для типу T буде визначено таким чином. Якщо тип T втілює універсальний інтерфейс IComparable<T>, засібом порівняння як усталено є метод CompareTo(T) цього інтерфейсу. Інакше, якщо тип T втілює непороджений ним інтерфейс IComparable, засіб порівняння як усталено є методом CompareTo(Object) цього інтерфейсу. Якщо тип T не втілює інтерфейс, то немає засобу порівняння як усталено, а делегат порівняння чи порівняння потрібно надати явно.

• Упорядкування List<T> не гарантовано. Необхідно упорядкувати список перед виконанням операцій (наприклад, BinarySearch), які вимагають упорядкування списку.

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

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

• Список приймає null як допустиме значення для типів посилань і дозволяє дублювати елементи.

• При прийнятті рішення про те, чи слід використовувати List<T> або ArrayList, обидва з яких мають аналогічну функціональність, потрібно пам'ятати, що List<T> працює краще у більшості випадків і є типобезпечним. Якщо використано тип посилань, поведінка двох класів ідентична.

• Якщо використано тип значення, компілятор створює втілення класу List<T> спеціально для цього типу значення. Це означає, що елемент List<T> списку об'єкта не потрібно запакувати перед використанням елемента, а після створення близько 500 елементів списку пам'ять, збережена не елементами списку боксу, більше пам'яті, використаної для створення втілення класу.

• List<T>() — ініціалізує порожній список, що має початкову ємність як усталено.
• List<T>(IEnumerable<T>) — ініціалізує список з елементами, скопійованими з указаної колекції.
• List<T>(Int32) — ініціалізує порожній список із зазначеною початковою ємністю.

• Capacity — кількість елементів, які може вмістити структура даних без зміни розміру.
• Count — кількість елементів.
• Item[Int32] — елемент за вказаним індексом.

Методи

• Add(T) — додає об'єкт до кінця колекції.
• AddRange(IEnumerable<T>) — додає елементи вказаної колекції до кінця списку.
• AsReadOnly() — повертає для поточної колекції оболонку ReadOnlyCollection&T>, доступну лише для читання.
• BinarySearch(Int32, Int32, T, IComparer<T>) — виконує пошук елемента в діапазоні елементів упорядкованого списку, використовуючи вказану функцію порівняння, та повертає індекс елемента, рахуючи від нуля.
• BinarySearch(T) — виконує пошук елемента по всьому упорядкованому списку, використовуючи порівнювач як усталено, і повертає індекс елемента, рахуючи від нуля.
• BinarySearch(T, IComparer<T>) — виконує пошук елемента по всьому відсортованому списку, використовуючи вказаний компаратор, і повертає індекс елемента, рахуючи від нуля.
• Clear() — видаляє зі списку всі елементи.
• Contains(T) — повертає true, якщо вказаний елемент є у списку.
• ConvertAll(Converter<T,TOutput>) — перетворює елементи поточного списку в інший тип і повертає перелік перетворених елементів.
• CopyTo(Int32, T[], Int32, Int32) — копіює діапазон елементів зі списку у сумісний одновимірний масив, починаючи зі вказаного індексу кінцевого масиву.
• CopyTo(T[]) — копіює весь список у сумісний одновимірний масив, починаючи з першого елемента цільового масиву.
• CopyTo(T[], Int32) — копіює список повністю в сумісний одновимірний масив, починаючи зі вказаного індексу кінцевого масиву.
• EnsureCapacity(Int32) — забезпечує ємність списку принаймні для вказаного рівня шляхом подвоєння поточного значення удвічі до прийнятного рівня.
• Equals(Object) — повертає true, якщо вказаний об'єкт дорівнює поточному об'єкту. Інакше повертає false. (успадковано від Object).
• Exists(Predicate<T>) — повертає true, якщо список містить елементи, які задовольняють умовам вказаного предикату.
• Find(Predicate<T>) — виконує пошук елемента списку, що відповідає умовам вказаного предикату, і повертає перше знайдене входження.
• FindAll(Predicate<T>) — повертає всі елементи списку, які відповідають умовам вказаного предикату.
• FindIndex(Int32, Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс першого входження у вказаному діапазоні елементів списку List<T>, що починається із заданого індексу і містить зазначену кількість елементів.
• FindIndex(Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс першого входження в діапазоні елементів списку, починаючи зі вказаного значення індексу й закінчуючи останнім елементом.
• FindIndex(Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс першого знайденого входження у межах всього списку.
• FindLast(Predicate<T>) — виконує пошук елемента, що відповідає умовам вказаного предикату, і повертає останнє знайдене входження у межах всього списку.
• FindLastIndex(Int32, Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс останнього входження в діапазоні елементів списку, що містить вказану кількість елементів і закінчується елементом із заданим індексом.
• FindLastIndex(Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс останнього входження в діапазоні елементів списку, починаючи з першого елемента і закінчуючи елементом із заданим індексом.
• FindLastIndex(Predicate<T>) — виконує пошук елемента, що задовольняє умовам вказаного предикату, і повертає індекс останнього знайденого входження у межах всього списку.
• ForEach(Action<T>) — виконує вказану дію з кожним елементом списку.
• GetEnumerator() — повертає перечислювач, який здійснює перебір елементів списку.
• GetHashCode() — повертає хеш-функцію як усталено (успадковано від Object).
• GetRange(Int32, Int32) — створює неповну копію діапазону елементів вихідного списку.
• GetType() — повертає об'єкт Type для поточного екземпляра (успадковано від Object)
• IndexOf(T) — здійснює пошук вказаного об'єкта і повертає індекс першого входження, рахуючи від нуля, знайденого у межах всього списку.
• IndexOf(T, Int32) — здійснює пошук вказаного об'єкта і повертає індекс першого входження в діапазоні елементів списку, починаючи із заданого індексу і до останнього елемента.
• IndexOf(T, Int32, Int32) — виконує пошук вказаного об'єкта і повертає індекс його першого входження в діапазоні елементів списку, що починається із заданого індексу і містить зазначену кількість елементів.
• Insert(Int32, T) — ставить елемент у список за вказаним індексом.
• InsertRange(Int32, IEnumerable<T>) — вставляє елементи колекції до списку у позиції зі вказаним індексом.
• LastIndexOf(T) — здійснює пошук вказаного об'єкта і повертає індекс останнього входження, рахуючи від нуля, знайденого в межах всього списку.
• LastIndexOf(T, Int32) — здійснює пошук вказаного об'єкта і повертає індекс останнього входження в діапазоні елементів списку, рахуючи від нуля, починаючи з першого елемента і до позиції із заданим індексом.
• LastIndexOf(T, Int32, Int32) — виконує пошук вказаного об'єкта і повертає індекс останнього входження в діапазоні елементів списку, рахуючи від нуля, містить зазначену кількість елементів і закінчується в позиції з вказаним індексом.
• MemberwiseClone() — створює неповну копію об'єкта Object (успадковано від Object).
• Remove(T) — видаляє перше входження вказаного об'єкта зі списку.
• RemoveAll(Predicate<T>) — видаляє всі елементи, які відповідають умовам вказаного предикату.
• RemoveAt(Int32) — видаляє елемент списку зі вказаним індексом.
• RemoveRange(Int32, Int32) — видаляє елементи з індексами у вказаному діапазоні.
• Reverse() — змінює порядок елементів у списку на зворотний.
• Reverse(Int32, Int32) — змінює порядок елементів у вказаному діапазоні значень індексів.
• Sort() — упорядковує елементи списку за допомогою функції порівняння як усталено.
• Sort(Comparison<T>) — упорядковує елементи в усьому списку за допомогою вказаного порівнювача — див. приклад коду з таким виведенням.
• Sort(IComparer<T>) — упорядковує елементи списку за допомогою вказаної функції порівняння — див. приклад коду з таким виведенням.
• Sort(Int32, Int32, IComparer<T>) — упорядковує елементи списку з індексами у вказаному діапазоні за допомогою вказаної функції порівняння.
• ToArray() — копіює елементи списку у новий масив.
• ToString() — повертає рядок, що становить поточний об'єкт (успадковано від Object).
• TrimExcess() — задає ємність, що дорівнює фактичному числу елементів у списку, якщо це число менше порогового значення.
• TrueForAll(Predicate<T>) — повертає true, якщо всі елементи списку відповідають умовам зазначеного предикату.

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