Сохранение файлов Excel в CSV, PDF и другие форматы
Различные способы сохранения ваших файлов
Aspose.Cells API предоставляет класс с именем Workbook, который представляет собой файл Excel и предоставляет все необходимые свойства и методы, которые могут понадобиться разработчикам для работы с их файлами Excel. Класс Workbook предоставляет метод save, который используется для сохранения файлов Excel. Метод save имеет множество вариантов перегрузки, которые используются для сохранения файлов Excel различными способами.
Разработчики также могут указать формат файла, в котором должны быть сохранены их файлы. Файлы могут быть сохранены в нескольких форматах, таких как XLS, SpreadsheetML, CSV, разделенные табуляциями, TSV, XPS и многие другие. Эти форматы файлов указываются с использованием перечисления SaveFormat.
Перечисление SaveFormat содержит множество предопределенных форматов файлов (которые могут быть выбраны вами) следующим образом:
| Типы форматов файлов | Описание |
|---|---|
| AUTO | API пытается определить соответствующий формат по указанному расширению файла в первом параметре метода сохранения |
| CSV | Представляет собой файл CSV |
| XLSX | Представляет файл формата Office Open XML SpreadsheetML |
| XLSM | Представляет файл формата на основе XML XLSM |
| XLTX | Представляет файл шаблона Excel |
| XLTM | Представляет файл шаблона с поддержкой макросов Excel |
| XLAM | Представляет файл Excel XLAM |
| TSV | Представляет файл значений, разделенных табуляцией |
| TAB_DELIMITED | Представляет файл с текстом, разделенным табуляцией |
| HTML | Представляет файл(ы) HTML |
| M_HTML | Представляет файл(ы) MHTML |
| ODS | Представляет файл таблицы OpenDocument |
| EXCEL_97_TO_2003 | Представляет файл XLS, который является форматом по умолчанию для ревизий Excel 1997 по 2003 годы |
| SPREADSHEET_ML | Представляет файл SpreadSheetML |
| XLSB | Представляет двоичный файл Excel 2007 XLSB |
| UNKNOWN | Представляет нераспознанный формат, не может быть сохранен. |
| Представляет документ PDF | |
| XPS | Представляет файл формата XML Paper Specification (XPS) |
| TIFF | Представляет файл формата Tagged Image File Format (TIFF) |
| SVG | Представляет файл формата XML-based Scalable Vector Graphics (SVG) |
| DIF | Представляет формат обмена данными. |
| NUMBERS | Представляет файл чисел. |
| MARKDOWN | Представляет документ в формате markdown. |
| Обычно существуют два способа сохранения файлов Excel следующим образом: |
- Сохранение файла в выбранное место
- Сохранение файла в поток
Сохранение файла в указанное местоположение
Если разработчикам нужно сохранить их файлы в каком-либо месте хранения, то они могут просто указать имя файла (с полным путем к хранению) и желаемый формат файла (используя перечисление SaveFormat) при вызове метода save объекта Workbook.
Пример:
Сохранение рабочей книги в текстовом или CSV формате
Иногда вам нужно преобразовать или сохранить книгу с несколькими листами в текстовом формате. Для текстовых форматов (например, TXT, TabDelim, CSV и т. д.), по умолчанию как Microsoft Excel, так и Aspose.Cells сохраняют содержимое только активного листа.
В следующем примере кода объясняется, как сохранить всю книгу в текстовом формате. Загрузите исходную книгу, которая может быть любым файлом электронных таблиц Microsoft Excel или OpenOffice (например, XLS, XLSX, XLSM, XLSB, ODS и т. д.) с любым количеством листов.
При выполнении кода конвертируются данные всех листов книги в формат TXT.
Вы можете изменить тот же пример для сохранения файла в формат CSV. По умолчанию TxtSaveOptions.Separator - это запятая, поэтому не указывайте разделитель при сохранении в формат CSV. Обратите внимание: если вы используете оценочную версию и даже если параметр метода TxtSaveOptions.setExportAllSheets(boolean value) установлен в true, программа все равно будет экспортировать только один лист.
Пример:
Сохранение текстовых файлов с пользовательским разделителем
Текстовые файлы содержат данные электронных таблиц без форматирования. Файл представляет собой своего рода обычный текстовый файл, который может содержать некоторые настраиваемые разделители между его данными.
Сохранение файла в поток
Если разработчикам нужно сохранить их файлы в поток, то они должны создать объект FileOutputStream и затем сохранить файл в этот поток, вызвав метод save объекта Workbook. Разработчики также могут указать желаемый формат файла (используя перечисление SaveFormat) при вызове метода save.
Пример:
Сохранение файла в другом формате
XLS Файлы
XLSX Файлы
PDF Файлы
Установите опцию ContentCopyForAccessibility
С помощью класса PdfSaveOptions вы можете получить или установить опцию PDF AccessibilityExtractContent, чтобы контролировать доступ к содержимому в преобразованном PDF. Это позволяет программному обеспечению для работы со скринридерами использовать текст внутри PDF-файла для чтения PDF-файла. Вы можете отключить это, применив пароль для изменения разрешений и сняв выбор двух элементов на скриншоте здесь.
Экспорт пользовательских свойств в PDF
С помощью класса PdfSaveOptions вы можете экспортировать пользовательские свойства из исходной книги в PDF. Для указания способа экспорта предоставляется перечисление PdfCustomPropertiesExport. Эти свойства можно просмотреть в Adobe Acrobat Reader, нажав на пункт File, а затем свойства, как показано на следующем изображении. Файл-шаблон “sourceWithCustProps.xlsx” можно скачать здесь для тестирования, а выходной PDF-файл “outSourceWithCustProps” доступен здесь для анализа.
Преобразование электронной таблицы Excel в Markdown
API Aspose.Cells поддерживает экспорт электронных таблиц в формат Markdown. Чтобы экспортировать активный лист в формат Markdown, передайте SaveFormat.Markdown вторым параметром метода Workbook.Save. Вы также можете использовать класс MarkdownSaveOptions, чтобы указать дополнительные настройки для экспорта листа в Markdown.
Приведен пример кода, демонстрирующий экспорт активного листа в формат Markdown с использованием члена перечисления SaveFormat.Markdown. Пожалуйста, ознакомьтесь с выходным файлом Markdown, сгенерированным кодом для справки.