MatchCollection.GetEnumerator Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetours
Objet qui contient tous les objets Match au sein de la MatchCollection.
Implémente
Exceptions
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.
