Метод GetEnumerator (Объект Collection)
Обновлен: Ноябрь 2007
Возвращает ссылку на объект перечислителя, который используется для прохода по Объект Collection (Visual Basic).
Public Function GetEnumerator() As IEnumerator
Заметки
Инструкция For Each... Next (Visual Basic) вызывает GetEnumerator для получения объекта перечислителя для поддержки итерации по коллекции элементов. Как правило, используется цикл For Each...Next для прохода коллекции или массива, и не требуется явно вызывать GetEnumerator.
Если требуется более тщательно контролировать итерацию, чем при помощи инструкций For Each...Next, можно использовать метод GetEnumerator для выполнения пользовательского обхода. Ниже приведены некоторые случаи, в которых это может потребоваться.
Возможно, потребуется вернуться в начало коллекции и запустить итерацию снова до ее завершения.
Возможно, потребуется пропустить один или несколько элементов по различным причинам.
Может потребоваться изменить элементы коллекции в середине обхода. В этом случае необходимо получить новый объект перечислителя, так как предыдущий является недействительным.
Пример
В следующем примере показано использование GetEnumerator для извлечения всех элементов объекта Collection.
Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
thisCustomer = custEnum.Current()
' Insert code to process this element of the collection.
End While
GetEnumerator создает и возвращает объект перечислителя, который реализует интерфейс IEnumerator пространства имен System.Collections. Объект перечислителя предоставляет свойство Current и методы MoveNext и Reset. Дополнительные сведения см. в разделе Инструкция For Each... Next (Visual Basic).
Требования
Пространство имен: Microsoft.VisualBasic
Модуль: Collection
Сборка: Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)