Collection.GetEnumerator Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Collection.vb

Zwraca moduł wyliczający, który iteruje po kolekcji.

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

public System.Collections.IEnumerator GetEnumerator ();

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

Public Function GetEnumerator () As IEnumerator

Zwraca

IEnumerator

Moduł wyliczający, który może służyć do iterowania po kolekcji.

Przykłady

W poniższym przykładzie pokazano, jak pobrać wszystkie elementy Collection obiektu przy użyciu metody GetEnumerator .

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 tworzy i zwraca obiekt modułu wyliczającego, który implementuje IEnumerator interfejs System.Collections przestrzeni nazw. Obiekt modułu wyliczającego uwidacznia Current właściwość i MoveNext metody i Reset . Aby uzyskać więcej informacji, zobacz For Each... (Dla każdego... Następna instrukcja.

Uwagi

Dla każdego... Następna instrukcja wywołuje metodę GetEnumerator w celu uzyskania obiektu modułu wyliczającego w celu obsługi iteracji elementów kolekcji. Zwykle używasz pętli ...Next do przechodzenia For Eachprzez kolekcję lub tablicę i nie trzeba wywoływać GetEnumerator jawnie.

Jeśli potrzebujesz większej kontroli nad iteracją niż For Eachzapewniają instrukcje ...Next , możesz użyć GetEnumerator metody do wykonania dostosowanego przechodzenia. Poniżej przedstawiono niektóre przypadki, w których może być konieczne wykonanie tej czynności.

• Możesz chcieć wrócić do początku kolekcji i uruchomić iterację ponownie, zanim zostanie zakończona.

• Możesz pominąć co najmniej jeden element z różnych powodów.

• Może być konieczne zmianę elementów kolekcji w środku przechodzenia. W takim przypadku należy uzyskać nowy obiekt modułu wyliczającego, ponieważ poprzedni obiekt jest unieważniany.