MatchCollection.GetEnumerator Méthode

Définition

Espace de noms:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Source:

MatchCollection.cs

Fournit un énumérateur qui itère au sein de la 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

Retours

IEnumerator

Objet qui contient tous les objets Match au sein de la MatchCollection.

Implémente

GetEnumerator()

Exceptions

RegexMatchTimeoutException

Un délai d’attente a expiré.

Remarques

Au lieu d’appeler la GetEnumerator méthode pour récupérer un énumérateur qui vous permet d’itérer à travers les Match objets de la collection, vous devez utiliser la construction d’itération de groupe (par foreach exemple, en C# et For Each...Next en Visual Basic) fournie par votre langage de programmation.

L’itération des membres de l’objet à l’aide MatchCollection de la GetEnumerator méthode (ou de l’instruction foreach en C# et de l’instruction For Each...Next en Visual Basic) fait que le moteur d’expression régulière remplit la collection selon les besoins à l’aide d’une évaluation différée. Cela est analogue à l’appel répété de la Regex.Match méthode, puis à l’ajout de la correspondance obtenue à l’objet MatchCollection . En revanche, le moteur d’expressions régulières utilise l’évaluation directe pour remplir la collection en même temps lorsque la Count propriété est accessible. Il peut s’agir d’une méthode beaucoup plus coûteuse pour créer la collection que l’évaluation paresseuse.

Étant donné que l’objet est généralement rempli à l’aide MatchCollection de l’évaluation différée, la tentative de navigation vers le membre suivant de la collection peut lever une RegexMatchTimeoutException exception. Cette exception peut être levée si une valeur de délai d’attente pour les opérations de correspondance est en vigueur et que la tentative de recherche de la correspondance suivante dépasse cet intervalle de délai d’attente.