Как и где использовать перечислители

Перечислитель - это объект, который предоставляет возможность обхода контейнера или коллекции. Перечислители могут использоваться для чтения данных в коллекции, но они не могут использоваться для изменения основной коллекции, в то время как IEnumerable - это интерфейс, который определяет один метод GetEnumerator, который возвращает интерфейс IEnumerator, который, в свою очередь, позволяет только для чтения доступ к коллекции.

API Aspose.Cells предоставляет множество перечислителей, однако в данной статье обсуждаются в основном три типа, перечисленные ниже.

1. Перечислитель ячеек
2. Перечислитель строк
3. Перечислитель столбцов

Как использовать перечислители

Перечислитель ячеек

Существуют различные способы доступа к перечислителю ячеек, и можно использовать любые из этих методов в зависимости от требований приложения. Вот методы, возвращающие перечислитель ячеек.

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

Все вышеперечисленные методы возвращают перечислитель, который позволяет осуществлять обход коллекции ячеек, которые были инициализированы.

При обходе ячеек коллекция не должна изменяться (операции, которые приведут к созданию новой ячейки или удалению существующей). В противном случае перечислитель может не иметь возможности правильно обойти все ячейки (некоторые элементы могут быть обойдены повторно или пропущены).

Приведенный ниже пример кода демонстрирует реализацию интерфейса IEnumerator для коллекции Cells.

Перечислитель строк

Перечислитель строк можно получить при использовании метода RowCollection.GetEnumerator. Приведенный ниже пример кода демонстрирует реализацию интерфейса IEnumerator для RowCollection.

Перечислитель столбцов

Перечислитель столбцов можно получить при использовании метода ColumnCollection.GetEnumerator. Приведенный ниже пример кода демонстрирует реализацию интерфейса IEnumerator для ColumnCollection.

Где использовать перечислители

Чтобы обсудить преимущества использования перечислителей, давайте рассмотрим реальный пример.

Сценарий

Требование приложения состоит в том, чтобы обойти все ячейки в заданном Worksheet для чтения их значений. Существует несколько способов реализации этой цели. Некоторые из них показаны ниже.

Использование диапазона отображения

Использование MaxDataRow и MaxDataColumn

Как видите, оба вышеупомянутых подхода используют более или менее похожую логику: цикл по всем ячейкам в коллекции для чтения значений ячеек. Это может вызвать проблемы по ряду причин, о которых рассказано ниже.

1. API, такие как MaxRow, MaxDataRow, MaxColumn, MaxDataColumn и MaxDisplayRange, требуют дополнительного времени для сбора соответствующей статистики. В случае большой матрицы данных (строки x столбцы) использование этих API может отрицательно сказаться на производительности.
2. В большинстве случаев не все ячейки в заданном диапазоне созданы. В таких ситуациях проверка каждой ячейки в матрице не так эффективна, как проверка только инициализированных ячеек.
3. Доступ к ячейке в цикле в виде Cells row, column заставит создавать все объекты ячеек в диапазоне, что в конечном итоге может вызвать исключение OutOfMemoryException.

Заключение

Исходя из вышеуказанных фактов, возможны следующие сценарии использования перечислителей.

1. Требуется только чтение коллекции ячеек, то есть только проверка ячеек.
2. Необходимо пройти большое количество ячеек.
3. Требуется пройти только инициализированные ячейки/строки/столбцы.