MatchCollection.GetEnumerator Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een enumerator die door de verzameling wordt herhaald.
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 IEnumeratorRetouren
Een object dat alle Match objecten in het MatchCollectionobject bevat.
Implementeringen
Uitzonderingen
Er is een time-out opgetreden.
Opmerkingen
In plaats van de GetEnumerator() methode aan te roepen om een enumerator op te halen waarmee u de Match objecten in de verzameling kunt herhalen, moet u de verzamelings-iteratieconstructie gebruiken die wordt geleverd door uw programmeertaal (zoals foreach in C#).
Het herhalen van de leden van de MatchCollectionGetEnumerator() methode (of de foreach instructie) zorgt ervoor dat de reguliere expressie-engine de verzameling indien nodig vult met behulp van luie evaluatie. 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.
