Udostępnij za pośrednictwem


Collection.GetEnumerator Metoda

Definicja

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

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.

Dotyczy