Collection.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.
public:
System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator ();member this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorDevoluciones
Enumerador que se puede utilizar para recorrer en iteración la colección.
Ejemplos
En el ejemplo siguiente se muestra cómo usar GetEnumerator para recuperar todos los elementos de un Collection objeto .
Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
thisCustomer = custEnum.Current()
' Insert code to process this element of the collection.
End While
GetEnumerator construye y devuelve un objeto enumerador, que implementa la IEnumerator interfaz del System.Collections espacio de nombres . El objeto enumerador expone la Current propiedad y los MoveNext métodos y Reset . Para más información, consulte Instrucción For Each...Next.
Comentarios
Para cada... Next Statement llama GetEnumerator a para obtener un objeto enumerador para admitir la iteración en los elementos de una colección. Normalmente, se usa un For Eachbucle ...Next para atravesar una colección o matriz, y no es necesario llamar GetEnumerator explícitamente.
Si necesita un control más cercano sobre la iteración que las For Eachinstrucciones ...Next , puede usar el GetEnumerator método para realizar un recorrido personalizado. A continuación se muestran algunos casos en los que es posible que tenga que hacerlo.
Es posible que desee volver al principio de la colección e iniciar la iteración de nuevo antes de que finalice.
Es posible que desee omitir uno o varios elementos por diversos motivos.
Es posible que tenga que cambiar los elementos de la colección en medio de un recorrido. En este caso, debe obtener un nuevo objeto enumerador porque se invalida el anterior.
