Призначення класу Array — базовий клас для всіх масивів у середовищі CLR, що надає методи для створення, зміни, пошуку та упорядкування масивів.

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

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

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

Зауваження

• Клас Array не є частиною простору назв System.Collections. Однак його вважають колекцією, бо він ґрунтується на інтерфейсі IList.

• Клас Array є базовим класом для втілення мов, що підтримують масиви. Однак лише система та компілятори можуть явно успадковувати від класу Array. Користувачі повинні використовувати конструкції масивів, надані мовою програмування.

• Нижня межа Array — це індекс його першого елемента. Array може мати будь-яку нижню межу, але як усталено нижня межа дорівнює нулю. При створенні екземпляра класу за допомогою CreateInstance можна визначити іншу нижню межу Array. Багатовимірний об'єкт Array може мати різні межі для кожного вимірювання. Масив може мати трохи більше 32 вимірів.

• На відміну від класів у просторі імен System.Collections, Array має фіксовану ємність. Щоб збільшити ємність, необхідно створити новий об'єкт Array з необхідною ємністю, скопіювати елементи зі старого об'єкта Array в новий, а потім видалити старий Array.

• Розмір масиву обмежений максимальною кількістю елементів — 4 мільярди, а також максимальним індексом 0X7FEFFFFF у будь-якому заданому вимірі.

• .NET framework: як усталено максимальний розмір Array складає 2 гігабайти (ГБ). У 64-розрядному середовищі можна уникнути обмеження розміру, встановивши значення атрибута enabled елемента конфігурації gcAllowVeryLargeObjects рівним true в середовищі виконання.

• Одновимірні масиви втілюють універсальні інтерфейси
  System.Collections.Generic.IList<T>,
  System.Collections.Generic.ICollection<T>,
  System.Collections.Generic.IEnumerable<T>,
  System.Collections.Generic.IReadOnlyList<T>,
  System .Collections.Generic.IReadOnlyCollection<T>.
  Втілення надано масивам лише під час виконання програм, тому універсальні інтерфейси не відображено в синтаксисі оголошення класу Array. Ключовий момент, який необхідно враховувати при зведенні масиву до одного з цих інтерфейсів, полягає в тому, що члени, які додають, вставляють або видаляють елементи, викликають виняток NotSupportedException.

• Об'єкти Type надають відомості про оголошення типів масивів. Об'єкти Array з тим самим типом масиву мають однакові об'єкти Type.

• Type.IsArray і Type.GetElementType можуть не повертати очікувані результати з Array, тому що при зведенні масиву до типу Array результат — це об'єкт, який не є масивом. Тобто typeof(System.Array).IsArray повертає false, а typeof(System.Array).GetElementType повертає null.

• Метод Copy копіює елементи між масивами одного типу. Або різних типів при автоматичному зведенні типів.

• Деякі методи, наприклад CreateInstance, Copy, CopyTo, GetValue та SetValue, надають перевантаження, що приймають 64-розрядні цілі числа як параметри, для забезпечення можливості роботи з масивами великої ємності. LongLength та GetLongLength повертають 64-розрядні цілі числа, що вказують довжину масиву.

• Сортування Array не гарантується. Перед виконанням операцій, які потребують сортування Array (наприклад, BinarySearch), Array потрібно попередньо відсортувати.

• Використання об'єктів покажчиків Array у машинному коді не підтримано і викликає виняток NotSupportedException для деяких методів.

• IsFixedSize — повертає true, якщо поточний об'єкт має фіксований розмір. Інакше повертає fale.
• IsReadOnly — повертає true, якщо поточний об'єкт доступний лише для читання. Інакше повертає false.
• IsSynchronized — повертає true, якщо доступ до поточниго об'єкта синхронізовано (він є потоко­безпечним). Інакше повертає false.
• Length — повертає загальну кількість елементів у всіх вимірах.
• LongLength — повертає загальну кількість елементів у всіх вимірах як 64-розрядне ціле число.
• MaxLength — повертає максимальну кількість елементів, які можуть бути у масиві.
• Rank — повертає число вимірів об'єкта.
• SyncRoot — повертає об'єкт, за допомогою якого можна синхронізувати доступ до об'єкта.

Методи

• AsReadOnly<T>(T[]) — повертає для заданого масиву доступну лише для читання програму-оболонку.
• BinarySearch(Array, Int32, Int32, Object) — повертає індекс елемента вказаного упорядкованого одновимірного масиву у вказаному діапазоні з указаним значенням, використовуючи інтерфейс IComparable. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch(Array, Int32, Int32, Object, IComparer) — повертає індекс елемента вказаного упорядкованого одновимірного масиву у вказаному діапазоні з указаним значенням, використовуючи вказаний інтерфейс IComparer. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch(Array, Object) — повертає індекс елемента вказаного упорядкованого одновимірного масиву з указаним значенням, використовуючи інтерфейс IComparable. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch(Array, Object, IComparer) — повертає індекс елемента вказаного упорядкованого одновимірного масиву з указаним значенням, використовуючи вказаний універсальний інтерфейс IComparer. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch<T>(T[], Int32, Int32, T) — повертає індекс елемента вказаного упорядкованого одновимірного масиву у вказаному діапазоні з указаним значенням, використовуючи універсальний інтерфейс IComparabe<T>. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch<T>(T[], Int32, Int32, T, IComparer<T>) — повертає індекс елемента вказаного упорядкованого одновимірного масиву у вказаному діапазоні з указаним значенням, використовуючи вказаний універсальний інтерфейс IComparer<T>. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch<T>(T[], T) — повертає індекс елемента вказаного упорядкованого одновимірного масиву з указаним значенням, використовуючи універсальний інтерфейс IComparable<T>. При відсутності такого елемента повертає від'ємне ціле число.
• BinarySearch<T>(T[], T, IComparer<T>) — повертає індекс елемента вказаного упорядкованого одновимірного масиву з указаним значенням, використовуючи вказаний універсальний інтерфейс IComparer<T>. При відсутності такого елемента повертає від'ємне ціле число.
• Clear(Array) — надає елементам вказаного масиву значення як усталено для відповідного типу.
• Clear(Array, Int32, Int32) — надає елементам вказаного масиву у вказаному діапазоні значень індексів значення як усталено для відповідного типу.
• Clone() — повертає копію масиву.
• ConstrainedCopy(Array, Int32, Array, Int32, Int32) — копіює діапазон елементів вказаного масиву, починаючи з указаного індексу у джерелі, в інший вказаний масив, починаючи з заданого індексу призначення. У разі неможливості успішно скопіювати весь діапазон, всі зміни буде скасовано.
• ConvertAll<TInput,TOutput>(TInput[], Converter<TInput,TOutput>) — перетворює масив одного типу на масив іншого типу.
• Copy(Array, Array, Int32) — копіює діапазон елементів першого вказаного масиву, починаючи з першого елемента, і вставляє його в інший вказаний масив, також починаючи з першого елемента. Довжину діапазону задано як 32-бітове ціле число.
• Copy(Array, Array, Int64) — копіює діапазон елементів масиву, вказаного першим, починаючи з першого елемента, і вставляє його в інший вказаний масив, також починаючи з першого елемента. Довжину діапазону задано як 64-бітове ціле число.
• Copy(Array, Int32, Array, Int32, Int32) — копіює діапазон елементів масиву, вказаного першим, починаючи з вказаного індекса джерела, і вставляє його в інший вказаний масив, починаючи з указаного індекса призначення, вказаної довжини. Індекси та довжину діапазону задано як 32-бітове ціле число.
• Copy(Array, Int64, Array, Int64, Int64) — копіює діапазон елементів масиву, вказаного першим, починаючи з вказаного індекса джерела, і вставляє його в інший вказаний масив, починаючи з указаного індекса призначення, вказаної довжини. Індекси та довжину діапазону задано як 64-бітове ціле число.
• CopyTo(Array, Int32) — копіює всі елементи поточного одновимірного масиву в указаний одновимірний масив починаючи з зазначеного індексу в масиві призначення. Індекс задано як 32-бітове ціле число.
• CopyTo(Array, Int64) — копіює всі елементи поточного одновимірного масиву в указаний одновимірний масив починаючи з зазначеного індексу в масиві призначення. Індекс задано як 64-бітове ціле число.
• CreateInstance(Type, Int32) — створює одновимірний масив указаних типу й довжини та нумерацією з нуля.
• CreateInstance(Type, Int32, Int32) — створює 2-вимірний масив указаного типу із заданими довжинами за вимірами та нумерацією з нуля.
• CreateInstance(Type, Int32, Int32, Int32) — створює 3-вимірний масив указаного типу із заданими довжинами за вимірами та нумерацією з нуля
• CreateInstance(Type, Int32[]) — створює багатовимірний масив указаного типу із заданими значеннями довжини за вимірами та нумерацією з нуля. Довжини вимірів задано масивом 32-бітових цілих чисел.
• CreateInstance(Type, Int32[], Int32[]) — створює багатовимірний масив указаного типу із заданими значеннями довжини за вимірами та із заданими нижніми межами. Довжини вимірів та нижні межі індексів задано масивами 32-бітових цілих чисел.
• CreateInstance(Type, Int64[]) — створює багатовимірний масив указаного типу із заданими значеннями довжини за вимірами та нумерацією з нуля. Довжини вимірів задано масивом 64-бітових цілих чисел.
• Empty<T>() — повертає порожній масив.
• Equals(Object) — повертає true, якщо вказаний об'єкт дорівнює поточному. Інакше повертає false (успадковано від Object).
• Exists<T>(T[], Predicate<T>) — повертає true, якщо вказаний масив містить елементи, які відповідають умовам указаного предикату.
• Fill<T>(T[], T) — надає всім елементам вказаного масиву вказане значення.
• Fill<T>(T[], T, Int32, Int32) — надає вказане значення елементам указаного масиву, які знаходяться в діапазоні startIndex (включно) і наступній кількості count індексів.
• Find<T>(T[], Predicate<T>) — виконує пошук елемента, який відповідає умовам указаного предикату, і повертає перше знайдене входження у межах всього масиву.
• FindAll<T>(T[], Predicate<T>) — повертає всі елементи, які відповідають умовам указаного предикату.
• FindIndex<T>(T[], Int32, Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам указаного предикату, і повертає індекс першого входження в діапазоні, що починається з указаного індексу і містить указану кількість елементів.
• FindIndex<T>(T[], Int32, Predicate<T>) — виконує пошук елемента вказаного масиву, що задовольняє умовам указаного предикату, і повертає індекс першого входження, починаючи з заданого індексу і закінчуючи останнім елементом.
• FindIndex<T>(T[], Predicate<T>) — виконує пошук елемента, що задовольняє умовам указаного предикату, і повертає індекс першого знайденого входження в межах всього масиву.
• FindLast<T>(T[], Predicate<T>) — виконує пошук елемента, який відповідає умовам указаного предикату, і повертає останнє знайдене входження у межах всього масиву.
• FindLastIndex<T>(T[], Int32, Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам указаного предикату, і повертає індекс останнього входження в діапазоні, що містить указану кількість елементів і закінчується елементом з указаним індексом.
• FindLastIndex<T>(T[], Int32, Predicate<T>) — виконує пошук елемента, що задовольняє умовам указаного предикату, і повертає індекс останнього входження в діапазоні елементів від першого до елемента із заданим індексом.
• FindLastIndex<T>(T[], Predicate<T>) — виконує пошук елемента, що задовольняє умовам указаного предикату, і повертає індекс останнього знайденого входження у межах всього масиву.
• ForEach<T>(T[], Action<T>) — виконує вказану дію з кожним елементом вказаного масиву.
• GetEnumerator() — повертає об'єкт IEnumerator для масиву.
• GetHashCode() — хеш-функція як усталено (успадковано від Object).
• GetLength(Int32) — повертає 32-розрядне ціле число — кількість елементів у вказаному вимірі масиву.
• GetLongLength(Int32) — повертає 64-розрядне ціле число — кількість елементів у вказаному вимірі масиву.
• GetLowerBound(Int32) — повертає індекс першого елемента заданого виміру.
• GetType() — повертає об'єкт Type для поточного екземпляра (успадковано від Object).
• GetUpperBound(Int32) — отримує індекс останнього елемента заданого виміру.
• GetValue(Int32) — повертає значення в указаній позиції одновимірного масиву.
• GetValue(Int32, Int32) — повертає значення в указаній позиції двовимірного масиву.
• GetValue(Int32, Int32, Int32) — повертає значення в указаній позиції тривимірного масиву.
• GetValue(Int32[]) — повертає значення в указвній позиції багатовимірного масиву.
• GetValue(Int64) — повертає значення в указаній позиції одновимірного масиву.
• GetValue(Int64, Int64) — повертає значення в указаній позиції двовимірного масиву.
• GetValue(Int64, Int64, Int64) — повертає значення в указаній позиції тривимірного масиву.
• GetValue(Int64[]) — повертає значення в указаній позиції багатовимірного масиву.
• IndexOf(Array, Object) — виконує пошук указаного об'єкта всередині всього одновимірного масиву та повертає індекс першого входження.
• IndexOf(Array, Object, Int32) — виконує пошук указаного об'єкта в діапазоні елементів одновимірного масиву та повертає індекс першого знайденого збігу. Діапазон починається з указаного індексу та закінчується кінцем масиву.
• IndexOf(Array, Object, Int32, Int32) — виконує пошук указаного об'єкта в діапазоні елементів одновимірного масиву та повертає індекс першого знайденого збігу. Діапазон починається від указаного індексу і містить указану кількість елементів.
• IndexOf<T>(T[], T) — виконує пошук указаного об'єкта всередині всього одновимірного масиву та повертає індекс першого входження.
• IndexOf<T>(T[], T, Int32) — виконує пошук указаного об'єкта в діапазоні елементів одновимірного масиву та повертає індекс першого знайденого збігу. Діапазон починається з указаного індексу та закінчується кінцем масиву.
• IndexOf<T>(T[], T, Int32, Int32) — виконує пошук указаного об'єкта в діапазоні елементів одновимірного масиву та повертає індекс першого знайденого збігу. Діапазон починається від указаного індексу і містить вказану кількість елементів.
• Initialize() — ініціалізує кожен елемент масиву типу викликом конструктора без параметрів.
• LastIndexOf(Array, Object) — виконує пошук заданого об'єкта та повертає індекс його останнього входження всередині всього одновимірного масиву.
• LastIndexOf(Array, Object, Int32) — виконує пошук зазначеного об'єкта та повертає індекс його останнього входження в діапазоні елементів одновимірного масиву, який починається з першого елемента та закінчується елементом із заданим індексом.
• LastIndexOf(Array, Object, Int32, Int32) — виконує пошук указаного об'єкта та повертає індекс останнього входження в діапазоні елементів одновимірного масиву, який містить вказану кількість елементів та закінчується елементом з указаним індексом.
• LastIndexOf<T>(T[], T) — виконує пошук указаного об'єкта та повертає індекс останнього входження в усьому масиві.
• LastIndexOf<T>(T[], T, Int32) — виконує пошук указаного об'єкта та повертає індекс останнього входження в діапазоні елементів масиву, починаючи з першого елемента та закінчуючи елементом із заданим індексом.
• LastIndexOf<T>(T[], T, Int32, Int32) — виконує пошук вказаного об'єкта та повертає індекс останнього входження в діапазоні елементів масиву Array, що містить вказану кількість елементів і закінчується в позиції із зазначеним індексом.
• MemberwiseClone() — створює неповну копію об'єкта (успадковано від Object).
• Resize<T>(T[], Int32) — змінює кількість елементів одновимірного масиву до зазначеної величини.
• Reverse(Array) — змінює порядок елементів одномірного масиву на зворотний.
• Reverse(Array, Int32, Int32) — змінює порядок послідовності елементів діапазону одновимірного масиву на зворотний.
• Reverse<T>(T[]) — змінює порядок послідовності елементів одномірного масиву на зворотний.
• Reverse<T>(T[], Int32, Int32) — змінює порядок послідовності елементів діапазону одномірного масиву на зворотний.
• SetValue(Object, Int32) — надає вказане значення елементу в указаній позиції одновимірного масиву.
• SetValue(Object, Int32, Int32) — надає вказане значення елементу в указаній позиції двовимірного масиву.
• SetValue(Object, Int32, Int32, Int32) — надає вказане значення елементу в указаній позиції тривимірного масиву Array.
• SetValue(Object, Int32[]) — надає вказане значення елементу в указаній позиції багатовимірного масиву.
• SetValue(Object, Int64) — надає вказане значення елементу в указаній позиції одновимірного масиву Array.
• SetValue(Object, Int64, Int64) — надає вказане значення елементу в указаній позиції 2-вимірного масиву.
• SetValue(Object, Int64, Int64, Int64) — надає значення елементу в указаній позиції 3-вимірного масиву.
• SetValue(Object, Int64[]) — надає значення елементу в указаній позиції багатовимірного масиву.
• Sort(Array) — упорядковує одновимірний масив, використовуючи реалізацію інтерфейсу IComparable кожного елемента масиву Array.
• Sort(Array, Array) — упорядковує пару одновимірних масивів (один містить ключі, а інший — відповідні значення) за ключами у першому масиві, використовуючи втілення інтерфейсу IComparable кожного ключа.
• Sort(Array, Array, IComparer) — упорядковує пару одновимірних масивів (один містить ключі, а інший — відповідні значення) за ключами у першому масиві, використовуючи вказаний інтерфейс IComparer.
• Sort(Array, Array, Int32, Int32) — упорядковує діапазон елементів у парі одновимірних масивів (один містить ключі, а інший – відповідні значення) за ключами у першому масиві, використовуючи втілення інтерфейсу IComparable кожного ключа.
• Sort(Array, Array, Int32, Int32, IComparer) — упорядковує діапазон елементів у парі одновимірних масивів (один містить ключі, а інший – відповідні значення) за ключами у першому масиві, використовуючи вказаний інтерфейс IComparer.
• Sort(Array, IComparer) — упорядковує елементи в одновимірному масиві, використовуючи вказаний інтерфейс IComparer.
• Sort(Array, Int32, Int32) — упорядковує елементи в діапазоні елементів одновимірного масиву за допомогою втілення інтерфейсу IComparable кожного елемента масиву.
• Sort(Array, Int32, Int32, IComparer) — упорядковує елементи в діапазоні елементів одновимірного масиву, використовуючи вказаний інтерфейс IComparer.
• Sort<T>(T[]) — упорядковує елементи всього масиву, використовуючи втілення універсального інтерфейсу IComparable кожного елемента масиву.
• Sort<T>(T[], Comparison<T>) — упорядковує елементи масиву за допомогою вказаного об'єкта Comparison<T> — див. приклад упорядкування інтервалів числової прямої за довжиною.
• Sort<T>(T[], IComparer<T>) — упорядковує елементи масиву, використовуючи вказаний універсальний інтерфейс IComparer<T>.
• Sort<T>(T[], Int32, Int32) — упорядковує елементи в діапазоні елементів масиву, використовуючи втілення універсального інтерфейсу IComparable кожного елемента масиву.
• Sort<T>(T[], Int32, Int32, IComparer<T>) — упорядковує елементи діапазону елементів масиву, використовуючи вказаний універсальний інтерфейс IComparer<T>.
• Sort<TKey,TValue>(TKey[], TValue[]) — упорядковує пару масивівy (один містить ключі, а інший — відповідні значення) за ключами у першому масиві, використовуючи втілення універсального інтерфейсу IComparable кожного ключа.
• Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) — упорядковує пару масивів (один містить ключі, а інший — відповідні значення) за ключами у першому масиві, використовуючи вказаний універсальний інтерфейс IComparer<T>.
• Sort<TKey,TValue>(TKey[], TValue[], Int32, Int32) — упорядковує діапазон елементів у парі масивів (один містить ключі, а інший – відповідні значення) за ключами у першому масиві, використовуючи втілення універсального інтерфейсу IComparable кожного ключа.
• Sort<TKey,TValue>(TKey[], TValue[], Int32, Int32, IComparer<TKey>) — упорядковує діапазон елементів у парі масивів (один містить ключі, а інший — відповідні елементи) за ключами у першому масиві, використовуючи вказаний універсальний інтерфейс IComparer<T>.
• ToString() — повертає рядок, що становить поточний об'єкт (успадковано від Object).
• TrueForAll<T>(T[], Predicate<T>) — повертає true, якщо всі елементи масиву відповідають умовам вказаного предикату. Інакше повертає false/

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