MatchCollection.GetEnumerator MatchCollection.GetEnumerator MatchCollection.GetEnumerator MatchCollection.GetEnumerator Method

Definicja

Dostarcza moduł wyliczający, który iteruje po kolekcji.Provides an enumerator that iterates through the collection.

public:
 virtual System::Collections::IEnumerator ^ GetEnumerator();
public System.Collections.IEnumerator GetEnumerator ();
abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumerator
Public Function GetEnumerator () As IEnumerator

Zwraca

Obiekt, który zawiera wszystkie Match obiektów w ramach MatchCollection.An object that contains all Match objects within the MatchCollection.

Implementuje

Wyjątki

Uwagi

Zamiast wywoływać metodę GetEnumerator metodę, aby pobrać moduł wyliczający, który umożliwia iteracyjne przeglądanie Match obiekty w kolekcji, należy użyć konstrukcji iteracji grupy (takie jak foreach w języku C# i For Each...NextInstead of calling the GetEnumerator method to retrieve an enumerator that lets you iterate through the Match objects in the collection, you should use the group iteration construct (such as foreach in C# and For EachNext w języku Visual Basic) udostępniane przez język programowania.in Visual Basic) provided by your programming language.

Iteracja elementów członkowskich MatchCollection przy użyciu GetEnumerator — metoda (lub foreach instrukcji w języku C# i For Each... Next instrukcji w języku Visual Basic) powoduje, że aparat wyrażeń regularnych do wypełnienia kolekcji na jako potrzebne przy użyciu obliczanie z opóźnieniem.Iterating the members of the MatchCollection object using the GetEnumerator method (or the foreach statement in C# and the For Each...Next statement in Visual Basic) causes the regular expression engine to populate the collection on an as needed basis using lazy evaluation. To jest odpowiednikiem wielokrotne wywoływanie Regex.Match metody, a następnie dodając wynikowe pasuje do MatchCollection obiektu.This is analogous to repeatedly calling the Regex.Match method, and then adding the resulting match to the MatchCollection object. Z kolei aparat wyrażeń regularnych używa oceny bezpośrednich, aby wypełnić kolekcję wszystkie na raz podczas Count dostępu do właściwości.In contrast, the regular expression engine uses direct evaluation to populate the collection all at once when the Count property is accessed. Może to być znacznie bardziej kosztowne metody tworzenia kolekcji niż obliczanie z opóźnieniem.This can be a much more expensive method of building the collection than lazy evaluation.

Ponieważ MatchCollection obiektu ogólnie jest wypełniana przy użyciu obliczanie z opóźnieniem, próby przejścia do następnego elementu członkowskiego kolekcji może zgłaszać RegexMatchTimeoutException wyjątku.Because the MatchCollection object is generally populated by using lazy evaluation, trying to navigate to the next member of the collection may throw a RegexMatchTimeoutException exception. Ten wyjątek może zostać wygenerowany, jeśli wartość limitu czasu dla operacji dopasowywania jest aktywna, a próba Znajdź następny dopasowanie przekroczy ten interwał limitu czasu.This exception can be thrown if a time-out value for matching operations is in effect, and the attempt to find the next match exceeds that time-out interval.

Dotyczy