MatchCollection.GetEnumerator Méthode

Définition

Fournit un énumérateur qui itère au sein de la collection.Provides an enumerator that iterates through the 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

Objet qui contient tous les objets Match au sein de la MatchCollection.An object that contains all Match objects within the MatchCollection.

Implémente

Exceptions

Un délai d’attente a expiré.A time-out occurred.

Remarques

Au lieu d’appeler GetEnumerator la méthode pour récupérer un énumérateur qui vous permet d’itérer Match au sein des objets de la collection, vous devez utiliser la construction d’itération foreach de C# groupe For Each(comme dans et...NextInstead of calling the GetEnumerator method to retrieve an enumerator that lets you iterate through the Match objects in the collection, you should use the group iteration construct (such as foreach in C# and For EachNext dans Visual Basic) fourni par votre langage de programmation.in Visual Basic) provided by your programming language.

Itération des membres de l' MatchCollection objet à l' GetEnumerator aide de la méthode foreach (ou C# de For Eachl’instruction dans et... Next dans Visual Basic) fait que le moteur des expressions régulières remplit la collection en fonction des besoins à l’aide de l’évaluation paresseuse.Iterating the members of the MatchCollection object using the GetEnumerator method (or the foreach statement in C# and the For Each...Next statement in Visual Basic) causes the regular expression engine to populate the collection on an as needed basis using lazy evaluation. Cela équivaut à appeler la Regex.Match méthode à plusieurs reprises, puis à ajouter la correspondance obtenue à l' MatchCollection objet.This is analogous to repeatedly calling the Regex.Match method, and then adding the resulting match to the MatchCollection object. En revanche, le moteur d’expression régulière utilise l’évaluation directe pour remplir la collection en une seule Count fois lors de l’accès à la propriété.In contrast, the regular expression engine uses direct evaluation to populate the collection all at once when the Count property is accessed. Il peut s’agir d’une méthode beaucoup plus coûteuse de génération de la collection que l’évaluation paresseuse.This can be a much more expensive method of building the collection than lazy evaluation.

Étant donné MatchCollection que l’objet est généralement renseigné à l’aide de l’évaluation différée, la tentative de naviguer jusqu’au membre RegexMatchTimeoutException suivant de la collection peut lever une exception.Because the MatchCollection object is generally populated by using lazy evaluation, trying to navigate to the next member of the collection may throw a RegexMatchTimeoutException exception. Cette exception peut être levée si une valeur de délai d’attente pour les opérations de correspondance est activée et si la tentative de recherche de la correspondance suivante dépasse cet intervalle de délai d’attente.This exception can be thrown if a time-out value for matching operations is in effect, and the attempt to find the next match exceeds that time-out interval.

S’applique à