MatchCollection.GetEnumerator Methode

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

Retouren

Een object dat alle Match objecten in het MatchCollectionobject bevat.

Implementeringen

Uitzonderingen

Opmerkingen

In plaats van de methode GetEnumerator aan te roepen om een enumerator op te halen waarmee u de Match-objecten in de verzameling kunt doorlopen, moet u de groepsiteratieconstructie (zoals foreach in C# en For Each gebruiken... Next in Visual Basic) geleverd door uw programmeertaal.

De leden van het object MatchCollection herhalen met behulp van de methode GetEnumerator (of de instructie foreach in C# en de For Each... Next instructie in Visual Basic) zorgt ervoor dat de reguliere expressie-engine de verzameling indien nodig vult met behulp van luie evaluatie. Dit is vergelijkbaar met het herhaaldelijk aanroepen van de Regex.Match methode en het toevoegen van de resulterende overeenkomst aan het MatchCollection object. De engine voor reguliere expressies gebruikt daarentegen directe evaluatie om de verzameling in één keer te vullen wanneer de Count eigenschap wordt geopend. Dit kan een veel duurdere methode zijn om de verzameling te bouwen dan luie evaluatie.

Omdat het object over het MatchCollection algemeen wordt gevuld met behulp van luie evaluatie, kan het proberen om naar het volgende lid van de verzameling te navigeren een RegexMatchTimeoutException uitzondering genereren. Deze uitzondering kan worden gegenereerd als er een time-outwaarde voor overeenkomende bewerkingen van kracht is en de poging om de volgende overeenkomst te vinden die time-outinterval overschrijdt.