Compartir vía


Collection.GetEnumerator Método

Definición

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.IEnumerator
Public Function GetEnumerator () As IEnumerator

Devoluciones

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.

Se aplica a