Método GetEnumerator (Objeto da Coleção)
Retorna uma referência a um objeto enumerator, que é usado para iterar por um Objetos de Coleção (Visual Basic).
Public Function GetEnumerator() As IEnumerator
Comentários
O For each... Next demonstrativo (Visual Basic) chama GetEnumerator para obter um objeto enumerator para oferecer suporte à iteração sobre elementos de uma coleção.Normalmente, você usa um loop For Each... Next para atravessar uma coleção ou matriz, e você não precisará chamar GetEnumerator explicitamente.
Se você precisar de controle mais detalhado sobre a interação que as declarações For Each... Next fornecem, você pode usar o método GetEnumerator para executar uma passagem personalizada.A seguir estão alguns casos em que talvez você precise fazer isso.
Convém retornar ao início da coleção e iniciar a iteração novamente antes de ser concluído.
Você pode querer pular um ou mais elementos por uma variedade de razões.
Talvez seja necessário alterar os elementos da coleção no meio de uma passagem.Nesse caso, você deve obter um novo objeto enumerator porque um anterior está invalidado.
Exemplo
O exemplo a seguir mostra como usar GetEnumerator para recuperar todos os elementos de um objeto 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 constrói e retorna um objeto enumerator, que implementa a interface IEnumerator do espaço de nomes System.Collections.O objeto enumerator expõe a propriedade Current e os métodos MoveNext e Reset.Para obter mais informações, consulte For each... Next demonstrativo (Visual Basic).
Requisitos
Namespace:Microsoft.VisualBasic
**Módulo:**Collection
**Assembly:**Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)