Comment et où utiliser les énumérateurs

Un énumérateur est un objet qui fournit la capacité de parcourir un conteneur ou une collection. Les énumérateurs peuvent être utilisés pour lire les données dans la collection, mais ils ne peuvent pas être utilisés pour modifier la collection sous-jacente, tandis que IEnumerable est une interface qui définit une méthode GetEnumerator qui renvoie une interface IEnumerator, ce qui permet un accès en lecture seule à une collection.

Les API Aspose.Cells fournissent une multitude d’énumérateurs, cependant, cet article traite principalement des trois types énumérés ci-dessous.

1. Énumérateur de cellules
2. Énumérateur de lignes
3. Énumérateur de colonnes

Comment utiliser des énumérateurs

Énumérateur de cellules

Il existe diverses façons d’accéder à l’énumérateur de cellules, et l’on peut utiliser l’une de ces méthodes en fonction des besoins de l’application. Voici les méthodes qui renvoient l’énumérateur de cellules.

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

Toutes les méthodes mentionnées ci-dessus renvoient l’énumérateur qui permet de parcourir la collection de cellules qui ont été initialisées.

En parcourant les cellules, la collection ne doit pas être modifiée (des opérations qui entraîneront l’instanciation d’une nouvelle cellule ou la suppression d’une cellule existante). Sinon, l’énumérateur risque de ne pas pouvoir parcourir toutes les cellules correctement (certains éléments peuvent être parcourus de manière répétitive ou sautés).

L’exemple de code suivant montre l’implémentation de l’interface IEnumerator pour une collection de cellules.

Itérateur de lignes

L’itérateur de lignes peut être accédé lors de l’utilisation de la méthode RowCollection.GetEnumerator. L’exemple de code suivant montre l’implémentation de l’interface IEnumerator pour RowCollection.

Itérateur de colonnes

L’itérateur de colonnes peut être accédé lors de l’utilisation de la méthode ColumnCollection.GetEnumerator. L’exemple de code suivant montre l’implémentation de l’interface IEnumerator pour ColumnCollection.

Où utiliser les énumérateurs

Afin de discuter des avantages de l’utilisation des énumérateurs, prenons un exemple en temps réel.

Scénario

Une exigence de l’application est de parcourir toutes les cellules dans un Worksheet donné pour lire leurs valeurs. Il pourrait y avoir plusieurs façons de mettre en œuvre cet objectif. Quelques exemples sont indiqués ci-dessous.

Utilisation de la plage d’affichage

Utilisation de MaxDataRow & MaxDataColumn

Comme vous pouvez le constater, les deux approches ci-dessus utilisent plus ou moins une logique similaire, c’est-à-dire parcourir toutes les cellules de la collection pour lire les valeurs des cellules. Cela pourrait poser problème pour un certain nombre de raisons, comme discuté ci-dessous.

1. Les API telles que MaxRow, MaxDataRow, MaxColumn, MaxDataColumn & MaxDisplayRange nécessitent du temps supplémentaire pour rassembler les statistiques correspondantes. Dans le cas où la matrice de données (lignes x colonnes) est grande, l’utilisation de ces API pourrait entraîner une pénalité de performance.
2. Dans la plupart des cas, toutes les cellules dans une plage donnée ne sont pas instanciées. Dans de telles situations, vérifier chaque cellule dans la matrice n’est pas aussi efficace que de vérifier uniquement les cellules initialisées.
3. Accéder à une cellule dans une boucle en tant que Cells row, column entraînera l’instanciation de tous les objets de cellules dans une plage, ce qui pourrait finalement entraîner une OutOfMemoryException.

Conclusion

Sur la base des faits mentionnés ci-dessus, voici les scénarios possibles où les énumérateurs doivent être utilisés.

1. Un accès en lecture seule de la collection de cellules est requis, c’est-à-dire; la nécessité est uniquement d’inspecter les cellules.
2. Un grand nombre de cellules doit être parcouru.
3. Seules les cellules/rangées/colonnes initialisées doivent être parcourues.