Collection.GetEnumerator Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt einen Enumerator zurück, der die Auflistung durchläuft.
public:
System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();member this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorGibt zurück
Ein Aufzählungszeichen, mit dem die Auflistung durchlaufen werden kann.
Beispiele
Das folgende Beispiel zeigt, wie sie zum Abrufen aller Elemente eines Collection Objekts verwendet GetEnumerator werden.
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 erstellt und gibt ein Enumerationsobjekt zurück, das die IEnumerator Schnittstelle des System.Collections Namespace implementiert. Das Enumerationsobjekt macht die Eigenschaft und die CurrentMoveNext Methoden verfügbar Reset . Weitere Informationen finden Sie unter For Each...Next-Anweisung.
Hinweise
Die für jeden... Next Statement ruft auf GetEnumerator , um ein Enumerationsobjekt abzurufen, um die Iteration über die Elemente einer Auflistung zu unterstützen. Normalerweise verwenden Sie eine For Each...Next -Schleife, um eine Sammlung oder ein Array zu durchlaufen, und Sie müssen nicht explizit aufrufen GetEnumerator .
Wenn Sie eine genauere Kontrolle über die Iteration benötigen, als die von den ...Next -For EachAnweisungen bereitgestellt werden, können Sie die GetEnumerator Methode verwenden, um eine angepasste Durchquerung durchzuführen. Im Folgenden sind einige Fälle aufgeführt, in denen Sie dies möglicherweise tun müssen.
Möglicherweise möchten Sie zum Anfang der Sammlung zurückkehren und die Iteration erneut starten, bevor sie abgeschlossen ist.
Möglicherweise möchten Sie aus verschiedenen Gründen ein oder mehrere Elemente überspringen.
Möglicherweise müssen Sie die Elemente der Auflistung in der Mitte eines Traversals ändern. In diesem Fall müssen Sie ein neues Enumerationsobjekt abrufen, da das vorherige Objekt ungültig ist.
