Cómo y dónde utilizar los enumeradores

Un enumerador es un objeto que proporciona la capacidad de recorrer un contenedor o una colección. Los enumeradores se pueden usar para leer los datos en la colección, pero no se pueden usar para modificar la colección subyacente, mientras que IEnumerable es una interfaz que define un método GetEnumerator que devuelve una interfaz IEnumerator, esto, a su vez, permite el acceso de solo lectura a una colección.

Las API de Aspose.Cells proporcionan una serie de enumeradores, sin embargo, este artículo discute principalmente los tres tipos que se enumeran a continuación.

1. Enumerador de celdas
2. Enumerador de filas
3. Enumerador de columnas

Cómo usar Enumeradores

Enumerador de celdas

Hay diversas formas de acceder al enumerador de celdas, y se puede utilizar cualquiera de estos métodos según los requisitos de la aplicación. Aquí están los métodos que devuelven el enumerador de celdas.

1. Cells.GetEnumerator
2. Row.GetEnumerator
3. Range.GetEnumerator

Todos los métodos mencionados anteriormente devuelven el enumerador que permite recorrer la colección de celdas que han sido inicializadas.

Mientras se recorren las celdas, la colección no debe modificarse (operaciones que causarán una nueva celda que se instancie o celda existente que se elimine). De lo contrario, es posible que el enumerador no pueda recorrer todas las celdas correctamente (algunos elementos pueden ser recorridos repetidamente o ignorados).

El siguiente ejemplo de código demuestra la implementación de la interfaz IEnumerator para una colección de celdas.

Enumerador de filas

El Enumerador de filas se puede acceder mientras se usa el método RowCollection.GetEnumerator. El siguiente ejemplo de código demuestra la implementación de la interfaz IEnumerator para RowCollection.

Enumerador de columnas

El Enumerador de columnas se puede acceder mientras se usa el método ColumnCollection.GetEnumerator. El siguiente ejemplo de código demuestra la implementación de la interfaz IEnumerator para ColumnCollection.

Dónde usar Enumeradores

Para discutir las ventajas de usar enumeradores, tomemos un ejemplo en tiempo real.

Escenario

Un requisito de la aplicación es recorrer todas las celdas en un Worksheet dado para leer sus valores. Podría haber varias formas de implementar este objetivo. Se demuestran algunas a continuación.

Usando Rango de Visualización

Usando MaxDataRow y MaxDataColumn

Como puedes observar, ambos enfoques mencionados anteriormente utilizan más o menos una lógica similar; es decir, recorrer todas las celdas en la colección para leer los valores de las celdas. Esto podría ser problemático por varias razones, como se discute a continuación.

1. Las API como MaxRow, MaxDataRow, MaxColumn, MaxDataColumn y MaxDisplayRange requieren tiempo adicional para recopilar las estadísticas correspondientes. En caso de que la matriz de datos (filas x columnas) sea grande, el uso de estas API podría imponer una penalización en el rendimiento.
2. En la mayoría de los casos, no todas las celdas en un rango dado están instanciadas. En tales situaciones, verificar cada celda en la matriz no es tan eficiente en comparación con verificar solo las celdas inicializadas.
3. Acceder a una celda en un bucle como Cells fila, columna hará que se instancien todos los objetos de celda en un rango, lo que eventualmente podría causar OutOfMemoryException.

Conclusión

Con base en los hechos mencionados anteriormente, los siguientes son los posibles escenarios en los que se deben usar los enumeradores.

1. Se requiere acceso de solo lectura a la colección de celdas, es decir; el requisito es solo inspeccionar las celdas.
2. Se deben recorrer un gran número de celdas.
3. Solo se deben recorrer celdas/filas/columnas inicializadas.