Чтение диапазона

Read range

Элемент считывает данные из диапазона ячеек Excel и записывает их в переменную.

Путь до файла, тип драйвера и другие базовые настройки указываются в контейнере Приложение 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.

1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.

2. Распакуйте архив и откройте в Студии проект 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");

Python

app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX)
data = app.ReadRange("A1:C12", "Лист1")
data = app.ReadRangeInfo("A1:C12", "Лист1")
data = app.ReadRangeTable("A1:C12", "Лист1")

JavaScript

var app = _lib.LTools.Office.ExcelApp.Init(wf, "file", ";", _lib.LTools.Office.Model.InteropTypes.DX);
var data = app.ReadRange("A1:C12", "Лист1");
var data = app.ReadRangeInfo("A1:C12", "Лист1");
var data = app.ReadRangeTable("A1:C12", "Лист1");