ActivityCollection.IEnumerable<Activity>.GetEnumerator Метод

Определение

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

System.Workflow.ComponentModel

Сборка:

System.Workflow.ComponentModel.dll

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

 virtual System::Collections::Generic::IEnumerator<System::Workflow::ComponentModel::Activity ^> ^ System.Collections.Generic.IEnumerable<System.Workflow.ComponentModel.Activity>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Workflow::ComponentModel::Activity ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity> IEnumerable<Activity>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Workflow.ComponentModel.Activity>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity>
override this.System.Collections.Generic.IEnumerable<System.Workflow.ComponentModel.Activity>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Workflow.ComponentModel.Activity>

Function GetEnumerator () As IEnumerator(Of Activity) Implements IEnumerable(Of Activity).GetEnumerator

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

IEnumerator<Activity>

Объект IEnumerator<T>, который может использоваться для итерации элементов коллекции.

Реализации

GetEnumerator()

Комментарии

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

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

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

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

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

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

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

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