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 Enumerator, der zum Durchlaufen der Auflistung verwendet werden kann.
Beispiele
Im folgenden Beispiel wird gezeigt, wie sie verwenden GetEnumerator , um alle Elemente eines Collection -Objekts abzurufen.
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 Enumeratorobjekt zurück, das die IEnumerator Schnittstelle des System.Collections Namespace implementiert. Das Enumeratorobjekt macht die -Eigenschaft und die Current -Methode und Reset verfügbarMoveNext. Weitere Informationen finden Sie unter For Each...Next-Anweisung.
Hinweise
Die for Each... Next Statement ruft auf GetEnumerator , um ein Enumeratorobjekt zur Unterstützung der Iteration über die Elemente einer Auflistung zu erhalten. 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 For Each...Next -Anweisungen bieten, können Sie die GetEnumerator -Methode verwenden, um einen angepassten Durchlauf 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.
Sie können ein oder mehrere Elemente aus verschiedenen Gründen überspringen.
Möglicherweise müssen Sie die Elemente der Auflistung in der Mitte eines Durchlaufs ändern. In diesem Fall müssen Sie ein neues Enumeratorobjekt abrufen, da das vorherige objekt ungültig ist.
