MatchCollection.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.
Udostępnia moduł wyliczający, który iteruje za pośrednictwem kolekcji.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorZwraca
Obiekt, który zawiera wszystkie Match obiekty w obiekcie MatchCollection.
Implementuje
Wyjątki
Wystąpił limit czasu.
Uwagi
Zamiast wywoływać GetEnumerator() metodę w celu pobrania modułu wyliczającego, który umożliwia iterowanie przez Match obiekty w kolekcji, należy użyć konstrukcji iteracji kolekcji dostarczonej przez język programowania (na foreach przykład w języku C#).
Iterowanie elementów członkowskich MatchCollection metody ( GetEnumerator() lub foreach instrukcji) powoduje, że aparat wyrażeń regularnych wypełnia kolekcję zgodnie z potrzebami przy użyciu leniwej oceny. Natomiast aparat wyrażeń regularnych używa oceny bezpośredniej do wypełniania kolekcji jednocześnie po Count uzyskaniu dostępu do właściwości. Może to być znacznie droższa metoda tworzenia kolekcji niż leniwa ocena.
MatchCollection Ponieważ obiekt jest zwykle wypełniany przy użyciu oceny leniwej, próba przejścia do następnego elementu członkowskiego kolekcji może zgłosić RegexMatchTimeoutException wyjątek. Ten wyjątek można zgłosić, jeśli wartość limitu czasu dla pasujących operacji jest w mocy, a próba znalezienia następnego dopasowania przekracza ten interwał limitu czasu.
