MatchCollection.GetEnumerator Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Enumerator bereit, der die Auflistung durchläuft.
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 IEnumeratorGibt zurück
Ein Objekt, das alle Match Objekte innerhalb des MatchCollectionObjekts enthält.
Implementiert
Ausnahmen
Ein Timeout ist aufgetreten.
Hinweise
Anstatt die GetEnumerator() Methode zum Abrufen eines Enumerators abzurufen, mit dem Sie die Match Objekte in der Auflistung durchlaufen können, sollten Sie das von Der Programmiersprache (z foreach . B. in C#) bereitgestellte Iterationskonstrukt der Auflistung verwenden.
Durch das Durchlaufen der Elemente der Verwendung der MatchCollectionGetEnumerator() Methode (oder der foreach Anweisung) wird das Modul für reguläre Ausdrücke die Auflistung nach Bedarf mithilfe der faulen Auswertung aufgefüllt. Im Gegensatz dazu verwendet das Modul für reguläre Ausdrücke eine direkte Auswertung, um die Auflistung auf einmal aufzufüllen, wenn auf die Count Eigenschaft zugegriffen wird. Dies kann eine viel teurere Methode zur Erstellung der Sammlung sein als faule Auswertung.
Da das MatchCollection Objekt in der Regel mithilfe der faulen Auswertung aufgefüllt wird, kann der Versuch, zum nächsten Element der Auflistung zu navigieren, eine RegexMatchTimeoutException Ausnahme auslösen. Diese Ausnahme kann ausgelöst werden, wenn ein Timeoutwert für Abgleichsvorgänge wirksam ist und der Versuch, die nächste Übereinstimmung zu finden, dieses Timeoutintervall überschreitet.
