ТабличныйДокумент.Записать (SpreadsheetDocument.Write)

ТабличныйДокумент (SpreadsheetDocument)

Записать (Write)

Доступен, начиная с версии 8.1.

Вариант синтаксиса: В файл

Синтаксис:

Записать(<ИмяФайла>, <ТипФайлаТаблицы>, <Вложения>)

Параметры:

<ИмяФайла> (обязательный)

Тип: Строка.
Имя файла, в котором сохраняется табличный документ.

<ТипФайлаТаблицы> (необязательный)

Тип: ТипФайлаТабличногоДокумента.
Формат, в котором будет сохранен табличный документ.
Значение по умолчанию: MXL.

<Вложения> (необязательный)

Тип: КоллекцияВложенийPDF.
Объект, содержащий вложения PDF-документов.
Используется только при записи в форматы PDF и PDF/A-3.
Если табличный документ записывается в формате PDF или PDF/A-3 и указан параметр <Вложения>, то вложения добавляются в документ в формате PDF и PDF/A-3.

Описание варианта метода:

Запись табличного документа в файл.

Вариант синтаксиса: В поток

Синтаксис:

Записать(<Поток>, <ТипФайлаТаблицы>, <Вложения>)

Параметры:

<Поток> (обязательный)

Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток для записи табличного документа.

<ТипФайлаТаблицы> (необязательный)

Тип: ТипФайлаТабличногоДокумента.
Формат, в котором будет сохранен табличный документ.
Значение по умолчанию: MXL.

<Вложения> (необязательный)

Тип: КоллекцияВложенийPDF.
Объект, содержащий вложения PDF-документов.
Если табличный документ записывается в формате PDF или PDF/A-3 и указан параметр <Вложения>, то вложения добавляются в документ в формате PDF и PDF/A-3.

Описание варианта метода:

Запись табличного документа в поток.
При записи в поток допускается использование только форматов: ANSITXT, DOCX, XLSX, MXL, MXL7, ODS, PDF, TXT.
Внимание! В веб-клиенте использование данного варианта недоступно.

Описание:

Записывает табличный документ в файл.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание:

При работе на сервере, веб-клиенте или через внешнее соединение:Не поддерживается сохранение в PDF картинок типа Метафайл.
При работе на веб-клиенте вызов метода выполняет обращение к серверу.
При работе на мобильной платформе возможно сохранение только в форматах MXL и PDF.
При выводе в формат PDF шрифты, которые нельзя внедрять, а также шрифты, не являющиеся TrueType или OpenType, будут заменены на шрифт Arial. Если данный шрифт не обнаружен, то будет использован шрифт Helvetica.

Пример:

// запись документа в файл

ТабДок1.Записать("C:\My Documents\Таблица2.mxl");

// запись документа в поток в формате XLSX

Поток = ФайловыеПотоки.ОткрытьДляЗаписи(имяФайла);
ТабДок2.Записать(Поток, ТипФайлаТабличногоДокумента.XLSX);
Поток.Закрыть();

См. также:

ТабличныйДокумент, метод ЗаписатьАсинх
ТабличныйДокумент, метод НачатьЗапись

Использование в версии:

Доступен, начиная с версии 8.1.

Описание изменено в версии 8.3.18.


     Методическая информация