Vector3DCollection.GetEnumerator Метод

Определение

Пространство имен:

System.Windows.Media.Media3D

Сборка:

PresentationCore.dll

Возвращает перечислитель, который может выполнять итерации по коллекции.

public:
 System::Windows::Media::Media3D::Vector3DCollection::Enumerator GetEnumerator();

public System.Windows.Media.Media3D.Vector3DCollection.Enumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Windows.Media.Media3D.Vector3DCollection.Enumerator

Public Function GetEnumerator () As Vector3DCollection.Enumerator

Возвращаемое значение

Vector3DCollection.Enumerator

Перечислитель, который служит для прохода по коллекции.

Комментарии

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

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

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

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

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

У перечислителя нет эксклюзивного доступа к коллекции, поэтому перечисление коллекции не является потокобезопасной процедурой. Даже при синхронизации коллекции другие потоки по-прежнему могут изменять коллекцию, что приводит к тому, что перечислитель создает исключение. Для обеспечения потокобезопасности при перечислении можно либо заблокировать коллекцию на все время перечисления, либо перехватывать исключения, возникающие в результате изменений, внесенных другими потоками.