MatchCollection.GetEnumerator Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un enumerador que recorre en iteración la colección.
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 IEnumeratorDevoluciones
Objeto que contiene todos los objetos Match de la MatchCollection.
Implementaciones
Excepciones
Se agotó el tiempo de espera.
Comentarios
En lugar de llamar al GetEnumerator método para recuperar un enumerador que le permite recorrer en iteración los Match objetos de la colección, debe usar la construcción de iteración de grupo (como foreach en C# y For Each...Next en Visual Basic) proporcionado por el lenguaje de programación.
La iteración de los miembros del MatchCollection objeto mediante el GetEnumerator método (o la foreach instrucción en C# y la For Eachinstrucción ...Next de Visual Basic) hace que el motor de expresiones regulares rellene la colección según sea necesario mediante la evaluación diferida. Esto es análogo a llamar repetidamente al Regex.Match método y, a continuación, agregar la coincidencia resultante al MatchCollection objeto . Por el contrario, el motor de expresiones regulares usa la evaluación directa para rellenar la colección a la vez cuando se accede a la Count propiedad . Este puede ser un método mucho más costoso de compilar la colección que la evaluación diferida.
Dado que el MatchCollection objeto se rellena generalmente mediante la evaluación diferida, intentar navegar al siguiente miembro de la colección puede producir una RegexMatchTimeoutException excepción. Esta excepción se puede producir si hay un valor de tiempo de espera para las operaciones coincidentes y el intento de encontrar la siguiente coincidencia supera ese intervalo de tiempo de espera.