Чтение диапазона
Элемент считывает данные из диапазона ячеек и записывает их в переменную. Путь до файла указывается в контейнере Приложение Excel.
Свойства
Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. здесь.
| Свойство | Тип | Описание | Пример |
|---|---|---|---|
| Excel: | |||
| Диапазон | String | Диапазон считывания ячеек. Если вместо диапазона указать символ "*", будет прочитан весь лист. 🔹 Диапазон указывается в соответствии с выбранным стилем ссылок заголовков строк и столбцов. По умолчанию задан стиль ссылок A1. Стиль выбирается в самом приложении Excel, а также в свойствах контейнера Приложение Excel (см. состояние флага R1C1). | "A1:D12" |
| Страница | String | Название страницы в книге Excel | "List1" |
| Индекс страницы | Int32 | Порядковый номер листа в книге Excel | 0 |
| Формат даты | String | Явное указание формата даты. Используется, когда нужно согласовать строковый вид даты с форматом поля DateTime. Пример: "dd.MM.yyyy" или "MM/dd/yyyy" | "dd.MM.yyyy" |
| Вывод: | |||
| Строка заголовков | Boolean | Признак того, что первая строка содержит заголовки. При установке галочки заголовки будут учитываться. Свойство корректно работает только с переменной вывода DataTable. Учитывание заголовков впоследствии позволяет обращаться к данным столбца по его названию, а не индексу, что помогает снижать потенциальные ошибки | |
| Переменная (таблица) | System.Data.DataTable | Название переменной, в которую результат запишется в табличном виде | |
| Переменная (текст) | List<List<string>> | Название переменной, в которую результат запишется в виде текстовых значений | |
| Переменная (информация) | List<List <LTools.Office.Model.ExcelCellInfo>> | Название переменной, в которую запишутся значения ячеек и метаинформация: цвет шрифта, фона и т.п. | |
| Учитывать типы полей ячеек Excel | Boolean | Определяет, нужно ли учитывать типы ячеек в таблице Excel. При установке галочки типы будут учитываться |
Примечание. Выбор переменной вывода зависит от того, как вы планируете обращаться к полученным данным. Например, если вы выбрали переменную (таблица), то считанные данные можно будет обрабатывать по колонкам.
О том, как при отладке процесса просмотреть текущее значение переменной, можно узнать здесь.
Пример использования
RPA-проект с примером работы элемента находится в публичном репозитории Learning .
- Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
- Распакуйте архив и откройте в Студии проект WorkWithExcelExamples. Проект состоит из процессов-последовательностей.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX);
List<List<string>> data = app.ReadRange("A1:C12", "Лист1");
List<List<LTools.Office.Model.ExcelCellInfo>> data = app.ReadRangeInfo("A1:C12", "Лист1");
System.Data.DataTable data = app.ReadRangeTable("A1:C12", "Лист1");