Collection.GetEnumerator Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een enumerator die door de verzameling wordt herhaald.
public:
System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();member this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetouren
Een enumerator die kan worden gebruikt om de verzameling te herhalen.
Voorbeelden
In het volgende voorbeeld ziet u hoe GetEnumerator u alle elementen van een Collection object ophaalt.
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 bouwt en retourneert een enumerator-object, waarmee de IEnumerator interface van de System.Collections naamruimte wordt geïmplementeerd. Het enumerator-object maakt de Current eigenschap en de MoveNext methoden Reset beschikbaar. Zie For Each voor meer informatie... Volgende instructie.
Opmerkingen
De voor elke... Volgende instructie roept GetEnumerator aan om een enumerator-object te verkrijgen ter ondersteuning van iteratie over de elementen van een verzameling. Normaal gesproken gebruikt u een For Each...Next -lus om een verzameling of matrix te doorlopen en hoeft u niet expliciet aan te roepen GetEnumerator .
Als u meer controle nodig hebt over de iteratie dan de For Each...Next -instructies, kunt u de GetEnumerator methode gebruiken om een aangepaste doorkruising uit te voeren. Hier volgen enkele gevallen waarin u dit mogelijk moet doen.
Mogelijk wilt u teruggaan naar het begin van de verzameling en de iteratie opnieuw starten voordat deze is voltooid.
U kunt een of meer elementen om verschillende redenen overslaan.
Mogelijk moet u de elementen van de verzameling in het midden van een doorkruising wijzigen. In dit geval moet u een nieuw enumerator-object verkrijgen omdat de vorige ongeldig is.