MatchCollection.IEnumerable<Match>.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í.
Devuelve un enumerador que procesa una iteración en la colección.
virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Match ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Match ^>::GetEnumerator;System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match> IEnumerable<Match>.GetEnumerator ();abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Match>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Match>Function GetEnumerator () As IEnumerator(Of Match) Implements IEnumerable(Of Match).GetEnumeratorDevoluciones
Enumerador que se puede utilizar para recorrer en iteración la colección.
Implementaciones
Excepciones
La colección es de solo lectura.
Comentarios
El devuelto IEnumerator<T> proporciona la capacidad de recorrer en iteración la colección mediante la exposición de una Current propiedad . Puede usar enumeradores para leer los datos de una colección, pero no para modificar la colección.
En principio, el enumerador se coloca antes del primer elemento de la colección. En esta posición, el valor de propiedad Current está sin definir. Por lo tanto, debe llamar al MoveNext método para avanzar el enumerador al primer elemento de la colección antes de leer el valor de Current.
Current devuelve el mismo objeto hasta MoveNext que se llama de nuevo como MoveNext establece Current en el elemento siguiente.
Si MoveNext pasa el final de la colección, el enumerador se coloca después del último elemento de la colección y MoveNext devuelve false. Cuando el enumerador está en esta posición, las llamadas posteriores a MoveNext también devuelven false. Si la última llamada a MoveNext se falsedevuelve , Current no está definida. No puede volver a establecer la propiedad Current en el primer elemento de la colección, sino que debe crear una nueva instancia del enumerador. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el comportamiento del enumerador no está definido.
Un enumerador no tiene acceso exclusivo a la colección, por lo que un enumerador permanece válido siempre que la colección permanezca sin cambios. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida y puede obtener resultados inesperados. Además, la enumeración de una colección no es un procedimiento seguro para subprocesos. Para garantizar la seguridad de subprocesos, debe bloquear la colección durante el enumerador o implementar la sincronización en la colección.
Las implementaciones predeterminadas de colecciones en el System.Collections.Generic espacio de nombres no se sincronizan.
