CaptureCollection.IEnumerable<Capture>.GetEnumerator Método

Definición

Devuelve un enumerador que procesa una iteración en la colección.Returns an enumerator that iterates through the collection.

 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.An enumerator that can be used to iterate through the collection.

Implementaciones

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 utilizar los enumeradores para leer los datos de una colección, pero no para modificar la colección.The returned IEnumerator<T> provides the ability to iterate through the collection by exposing a Current property .You can use enumerators to read the data in a collection, but not to modify the collection.
En principio, el enumerador se coloca antes del primer elemento de la colección.Initially, the enumerator is positioned before the first element in the collection. En esta posición, el valor de propiedad Current está sin definir.At this position, Current is undefined. Por lo tanto, debe llamar al MoveNext método para avanzar el enumerador hasta el primer elemento de la colección antes de leer el valor de Current .Therefore, you must call the MoveNext method to advance the enumerator to the first element of the collection before reading the value of Current.
Current Devuelve el mismo objeto hasta que MoveNext se llama de nuevo a como MoveNext establece Current en el elemento siguiente.Current returns the same object until MoveNext is called again as MoveNext sets Current to the next element.
Si MoveNext pasa el final de la colección, el enumerador se coloca detrás del último elemento de la colección y MoveNext devuelve false .If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. Cuando el enumerador está en esta posición, las llamadas subsiguientes a MoveNext también devuelven false .When the enumerator is at this position, subsequent calls to MoveNext also return false. Si la última llamada a MoveNext devolvió false , Current no está definida.If the last call to MoveNext returned false, Current is undefined. 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.You cannot set Current to the first element of the collection again; you must create a new enumerator instance instead. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el comportamiento del enumerador es indefinido.If changes are made to the collection, such as adding, modifying, or deleting elements, the behavior of the enumerator is undefined.
Un enumerador no tiene acceso exclusivo a la colección, por lo que un enumerador sigue siendo válido mientras la colección permanezca sin cambios.An enumerator does not have exclusive access to the collection so an enumerator remains valid as long as the collection remains unchanged. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador queda invalidado y puede obtener resultados inesperados.If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is invalidated and you may get unexpected results. Además, la enumeración de una colección no es un procedimiento seguro para subprocesos.Also, enumerating a collection is not a thread-safe procedure. Para garantizar la seguridad para subprocesos, debe bloquear la colección durante el enumerador o implementar la sincronización en la colección.To guarantee thread-safety, you should lock the collection during enumerator or implement synchronization on the collection.
Las implementaciones predeterminadas de las colecciones del System.Collections.Generic espacio de nombres no están sincronizadas.Default implementations of collections in the System.Collections.Generic namespace aren't synchronized.

Se aplica a