Призначення класу HashSet — колекція для зберігання множини значень.

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

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

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

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

• Клас HashSet, заснований на моделі математичних множин, надає високопродуктивні операції, аналогічні доступу до ключів колекцій Dictionary. Клас HashSet можна тлумачити як колекцію Dictionary без значень.

• Колекцію HashSet не упорядковано. Вона не може містити значення, що повторюються. Якщо порядок або дублювання елементів для програми важливіше за продуктивність, використовують List разом з методом Sort.

• Операції HashSet:
  • UnionWith — об'єднання;
  • IntersectWith — перетин;
  • ExceptWith — різниця;
  • SymmetricExceptWith — симетрична різниця.
  Додатково до перелічених операцій клас надає методи визначення рівності, перекриття і те, чи є набір підмножиною чи надмножиною іншого набору.

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

• HashSet<T>() — ініціалізує порожній представник, який використовує функцію порівняння як усталено.

• HashSet<T>(IEnumerable<T>) — ініціалізує представник з функцією порівняння як усталено, містить елементи, скопійовані із вказаної колекції, і має ємність, достатню для того, щоб вмістити кількість скопійованих елементів.

• HashSet<T>(IEnumerable<T>, IEqualityComparer<T>) — ініціалізує представник класу, який викорис­товує задану функцію порівняння, містить елементи, скопійовані із вказаної колекції, і має ємність, достатню для того, щоб вмістити кількість скопійованих елементів.

• HashSet<T>(IEqualityComparer<T>) — ініціалізує порожній екземпляр класу, який використовує вказану функцію порівняння.

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

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

• HashSet<T>(SerializationInfo, StreamingContext) — ініціалізує новий екземпляр класу з серіалізо­ваними даними.

Властивості

• Comparer — повертає об'єкт IEqualityComparer<T>, використаний для визначення рівності значень.
• Count — повертає кількість наявний у колекції елементів.

• Add(T) — додає вказаний елемент до чножини.
• Clear() — видаляє всі елементи.
• Contains(T) — визначає, чи об'єкт HashSet містить указаний елемент.
• CopyTo(T[]) — копіює елементи об'єкта HashSet у масив.
• CopyTo(T[], Int32) — копіює елементи об'єкта в указаний масив, починаючи з указаного індексу.
• CopyTo(T[], Int32, Int32) — копіює вказану кількість елементів об'єкта у масив, починаючи з указаного індексу масиву.
• CreateSetComparer() — повертає об'єкт IEqualityComparer, який можна використовувати для перевірки рівності об'єкта HashSet.
• EnsureCapacity(Int32) — гарантує, що поточний об'єкт може містити вказану кількість елементів без зростання.
• Equals(Object) — повертає trиe, якщо об'єкт дорівнює поточному. Інакше повертає false (успадковано від Object).
• ExceptWith(IEnumerable<T>) — видаляє всі елементи вказаної колекції з поточного об'єкта.
• GetEnumerator() — повертає перечислювач, який виконує перелік елементів об'єкта.
• GetHashCode() — хеш-функція як усталено (успадковано від Object).
• GetObjectData(SerializationInfo, StreamingContext) — втілює інтерфейс ISerializable та повертає дані, необхідні для серіалізації об'єкта.
• GetType() — повертає об'єкт Type для поточного представника (успадковано від Object).
• IntersectWith(IEnumerable<T>) — змінює поточний об'єкт HashSet так, щоб він містив лише елементи, які є в цьому об'єкті й у вказаній колекції.
• IsProperSubsetOf(IEnumerable<T>) — повертає true, якщо об'єкт HashSet є строгою підмножиною вказаної колекції. Інакше повертає false.
• IsProperSupersetOf(IEnumerable<T>) — повертає true, якщо об'єкт HashSet є строгою надмножиною вказаної колекції. Інакше повертає false.
• IsSubsetOf(IEnumerable<T>) — повертає true, якщо поточний об'єкт є підмножиною вказаної колекції. Інакше повертає false.
• IsSupersetOf(IEnumerable<T>) — повертає true, якщо поточний об'єкт є надмножиною вказаної колекції. Інакше повертає false.
• MemberwiseClone() — повертає неповну копію об'єкта (успадковано від Object).
• OnDeserialization(Object) — втілює інтерфейс ISerializable і викликає подію десеріалізації при завершенні десеріалізації.
• Overlaps(IEnumerable<T>) — повертає true, якщо є спільні елементи поточного об'єкта і вказаної колекції.
• Remove(T) — видаляє вказаний елемент з поточного об'єкта.
• RemoveWhere(Predicate<T>) — видаляє всі елементи, при яких справджується вказаний предикат.
• SetEquals(IEnumerable<T>) — повертає true, якщо поточний об'єкт і вказана колекція одні й самі елементи.
• SymmetricExceptWith(IEnumerable<T>) — змінює поточний об'єкт так, щоб він містив лише елементи, які є або в цьому об'єкті, або в зазначеній колекції, але не одночасно в обох.
• ToString() — повертає рядок, що становить поточний об'єкт (успадковано від Object).
• TrimExcess() — задає ємність об'єкта HashSet, що дорівнює числу наявних елементів, округленому з надвишком до найближчого значення, передбаченого втіленням.
• TryGetValue(T, T) — виконує пошук вказаного значення в наборі й повертає однакове значення, якщо його вдалося знайти.
• UnionWith(IEnumerable<T>) — змінює поточний об'єкт так, щоб він містив усі елементи, наявні в ньому або у вказаній колекції (об'єднання елементів).

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