Table.Load

Load (Загрузка таблицы)
Объект: Электронная таблица Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, число, неверный файл Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Электронная таблица

Функция производит загрузку текущей таблицы из файла в указанном формате, предыдущие данные, находившиеся в таблице, будут утеряны.

Синтаксис

Table.Load(<Наименование файла (STRING)>,<Формат (INT,STRING)>,<Индекс или наименование листа (INT,STRING)>):<Наименование загруженного листа (STRING)>

Аргументы

• <Наименование файла (STRING)> - Аргумент задает наименование файла с путем и расширением. Путь может быть как серверным и так и локальным (Имена файлов). Если второй аргумент отсутствует, формат файла будет определен из расширения файла загрузки.
• <Формат (INT,STRING)> - (необязательный аргумент) Аргумент задает формат загружаемого файла в строковом или числовом виде. Если аргумент опущен, разгрузка будет происходить в формате соответствующем расширению файла. Доступны следующие значения:
  • 0 или SFT -- файл во внутреннем формате системы (sft)
  • 1 или XLS -- файл в формате Excel (xls)
  • 2 или XLSX -- (планируется к реализации) файл в формате Excel (xlsx)
• <Индекс или наименование листа (INT,STRING)> - (необязательный аргумент) Для форматов, хранящих более одного листа в файле (xls, xlsx), аргумент позволяет указать наименование загружаемого листа (если аргумент представляет строку) или индекс загружаемого листа (если аргумент представляет число, первый лист имеет индекс 1). Если аргумент опущен, будет загружен активный лист, либо первый лист, если активный лист недоступен. Если указанный по имени или индексу лист не найден, функция вызовет исключение.

Возвращаемое значение

Для форматов, хранящих более одного листа в файле (xls, xlsx), функция возвращает наименование загруженного листа, для остальных форматов (stf), будет возвращено пустое значение.

Примеры

Таб:=Table.Create();
Try
  Таб.Load(Файл,"XLS");
Except
  Message(PopError(),"!");
  Message("Ошибка при открытии файла "+Файл+"! Обратитесь к администратору!","!");
  Exit 0;
EndTry;  
  
If (Trim(Таб.Area(14,1,14,1).Text)<>"")or(Trim(Таб.Area(27,1,27,1).Text)<>"") Then
  Message("Файл "+Файл+" имеет неверный формат! Вы пытаетесь загрузить не тот файл!","!");
  Exit 0;  
EndIf;