GetEnumerator (Método, objeto Collection)
Actualización: noviembre 2007
Devuelve una referencia a un objeto enumerador que se utiliza para recorrer en iteración un objeto Collection (Objeto, Visual Basic).
Public Function GetEnumerator() As IEnumerator
Comentarios
La instrucción Instrucción For Each...Next (Visual Basic) llama al método GetEnumerator para obtener un objeto enumerador que admita la iteración en los elementos de una colección. Normalmente, se utiliza un bucle For Each...Next para recorrer una colección o una matriz, y no es necesario llamar explícitamente a GetEnumerator.
Si necesita tener mayor control sobre la iteración del que proporcionan las instrucciones For Each...Next, puede utilizar el método GetEnumerator para llevar a cabo un recorrido personalizado. A continuación se incluyen algunos casos en los que esta operación podría ser necesaria.
Si desea volver al principio de la colección e iniciar de nuevo la iteración antes de que finalice.
Si desea omitir uno o varios elementos por distintos motivos.
Si necesita cambiar los elementos de la colección en mitad de un recorrido. En este caso, debe obtener un nuevo objeto enumerador, ya que se invalida el anterior.
Ejemplo
En el ejemplo siguiente se muestra cómo se utiliza GetEnumerator para recuperar todos los elementos de un objeto Collection.
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 crea y devuelve un objeto enumerador que implementa la interfaz IEnumerator del espacio de nombres System.Collections. El objeto enumerador expone la propiedad Current y los métodos MoveNext y Reset. Para obtener más información, vea Instrucción For Each...Next (Visual Basic).
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**Collection
**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)