CaptureCollection.IEnumerable<Capture>.GetEnumerator Método

Definición

Espacio de nombres:

System.Text.RegularExpressions

Ensamblado:

System.Text.RegularExpressions.dll

Source:

CaptureCollection.cs

Devuelve un enumerador que procesa una iteración en la colección.

 virtual System::Collections::Generic::IEnumerator<System::Text::RegularExpressions::Capture ^> ^ System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator() = System::Collections::Generic::IEnumerable<System::Text::RegularExpressions::Capture ^>::GetEnumerator;

System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture> IEnumerable<Capture>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>
override this.System.Collections.Generic.IEnumerable<System.Text.RegularExpressions.Capture>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.Text.RegularExpressions.Capture>

Function GetEnumerator () As IEnumerator(Of Capture) Implements IEnumerable(Of Capture).GetEnumerator

Devoluciones

IEnumerator<Capture>

Enumerador que se puede utilizar para recorrer en iteración la colección.

Implementaciones

GetEnumerator()

Comentarios

El devuelto IEnumerator<T> proporciona la capacidad de recorrer en iteración la colección exponiendo 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 también devuelven MoveNextfalse. 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 y cuando 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 los subprocesos, debe bloquear la recopilació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.