Freigeben über


Collection.GetEnumerator Methode

Definition

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.IEnumerator
Public Function GetEnumerator () As IEnumerator

Gibt 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.

Gilt für: