Collection.GetEnumerator Método

public:
 System::Collections::IEnumerator ^ GetEnumerator();

public System.Collections.IEnumerator GetEnumerator();

member this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Function GetEnumerator () As IEnumerator

Devoluções

Um enumerador que pode ser usado para iterar pela coleção.

Exemplos

O exemplo seguinte mostra como usar GetEnumerator para recuperar todos os elementos de um Collection objeto.

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 devolve um objeto enumerador, que implementa a IEnumerator interface do System.Collections namespace. O objeto enumerador expõe a Current propriedade e os MoveNext métodos e Reset . Para obter mais informações, consulte Para cada um... Próxima declaração.

Observações

O For Each... A seguinte instrução pede GetEnumerator para obter um objeto enumerador para suportar a iteração sobre os elementos de uma coleção. Normalmente, usas um For Each...Next loop para atravessar uma coleção ou array, e não precisas de chamar GetEnumerator explicitamente.

Se precisares de controlo mais próximo da iteração do que as For Eachinstruções ...Next fornecem, podes usar o GetEnumerator método para realizar uma travessia personalizada. Seguem-se alguns casos em que poderá precisar de fazer isto.

• Pode querer voltar ao início da coleção e recomeçar a iteração antes de estar concluída.

• Pode querer saltar um ou mais elementos por várias razões.

• Pode ser necessário alterar os elementos da coleção a meio de uma viagem. Neste caso, deve obter um novo objeto enumerador porque o anterior está invalidado.