Collection.GetEnumerator Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.IEnumeratorPublic Function GetEnumerator () As IEnumeratorZwraca
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.
