MatchCollection.GetEnumerator Méthode

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

Objet qui contient tous les Match objets dans le MatchCollection.

Implémente

Exceptions

Remarques

Au lieu d’appeler la GetEnumerator méthode pour récupérer un énumérateur qui vous permet d’effectuer une itération dans 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 MatchCollection à l’aide de la GetEnumerator méthode (ou de l’instruction foreach en C# et de l’instruction For Each...Next en Visual Basic) entraîne le remplissage de la collection selon les besoins à l’aide de l’é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’expression régulière 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 de création de la collection que l’évaluation différée.

Étant donné que l’objet MatchCollection est généralement rempli à l’aide de l’évaluation différée, la tentative d’accès au 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 correspondantes est en vigueur et que la tentative de recherche de la correspondance suivante dépasse cet intervalle de délai d’attente.