HashSet<T>.Enumerator Структура

Определение

public: value class HashSet<T>::Enumerator : System::Collections::Generic::IEnumerator<T>

public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>

[System.Serializable]
public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>

type HashSet<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IEnumerator
    interface IDisposable

[<System.Serializable>]
type HashSet<'T>.Enumerator = struct
    interface IEnumerator<'T>
    interface IDisposable
    interface IEnumerator

Public Structure HashSet(Of T).Enumerator
Implements IEnumerator(Of T)

Параметры типа

Наследование

Object

ValueType

HashSet<T>.Enumerator

Атрибуты

SerializableAttribute

Реализации

IEnumerator<T> IEnumerator IDisposable

Комментарии

Оператор foreach языка C# (For Each в Visual Basic) скрывает сложность перечислителей. Поэтому рекомендуется использовать foreach вместо непосредственного управления перечислителем.

Перечислители можно использовать для чтения данных в коллекции, но их нельзя использовать для изменения базовой коллекции.

Изначально перечислитель размещается перед первым элементом в коллекции. На этой позиции Current свойство не определено. Поэтому необходимо вызвать MoveNext метод, чтобы перенаставить перечислителя в первый элемент коллекции, прежде чем считывать значение Current.

Current возвращает тот же объект до MoveNext вызова. MoveNext задает Current для следующего элемента.

Если MoveNext передает конец коллекции, перечислитель размещается после последнего элемента в коллекции и MoveNext возвращается false. Если перечислитель находится в этой позиции, последующие вызовы MoveNext также возвращаются false. Если последний вызов MoveNext возвращен false, Current не определен. Невозможно снова задать Current первый элемент коллекции. Вместо этого необходимо создать новый объект перечислителя.

Перечислитель остается допустимым, пока коллекция остается неизменной. Если изменения вносятся в коллекцию, например добавление, изменение или удаление элементов, перечислитель неустранимо недопустим, а следующий вызов MoveNext или вызов вызывает IEnumerator.ResetисключениеInvalidOperationException.

Перечислитель не имеет монопольного доступа к коллекции; Таким образом, перечисление через коллекцию по сути не является потокобезопасной процедурой. Чтобы гарантировать безопасность потоков во время перечисления, можно заблокировать коллекцию во время всего перечисления. Чтобы разрешить доступ к коллекции несколькими потоками для чтения и записи, необходимо реализовать собственную синхронизацию.

Реализации коллекций по умолчанию в System.Collections.Generic пространстве имен не синхронизируются.