Робота з XLSX Packaging
Робота з XLSX Packaging
Aspose.Cells FOSS for C++ reads and writes the .xlsx Відкрити формат XML через спеціальний шар серіалізації. XlsxWorkbookSerializer клас організовує завантаження та збереження всіх частин робочої книжки, включаючи таблиці роботи, стилі, визначені імена, властивості документів та автоматичні фільтри.
Завантаження та збереження файлів XLSX
Використовуйте Workbook клас для всіх операцій навантаження та збереження., XlsxWorkbookSerializer обробляє пакетировку Open XML:
#include "aspose/cells_foss/Workbook.h"
using namespace Aspose::Cells_FOSS;
int main() {
// Load existing XLSX
Workbook workbook("input.xlsx");
// Modify content...
// Save back to XLSX
workbook.Save("output.xlsx");
return 0;
}Властивості документа
Файли XLSX мають основні та розширені властивості документів (заголовок, автор, дата створення). XlsxDocumentProperties, що будує і завантажує docProps/core.xml і docProps/app.xml частини:
| Part | Управляється: | Contains |
|---|---|---|
docProps/core.xml | XlsxDocumentProperties::BuildCorePropertiesDocument | Назва, автор, створений, змінений |
docProps/app.xml | XlsxDocumentProperties::BuildExtendedPropertiesDocument | Назва заявки, версія |
Метадані та налаштування робочого листа
Метадані на рівні робочої книжки налаштування обчислень, перегляду книги та захист роботи XlsxWorkbookProperties:
BuildWorkbookPropertiesElementзаписує настройки розрахунку та ітерації в робочому книзіBuildWorkbookProtectionElementзаписує захист паролем на рівні робочої книжкиBuildBookViewsElementзаписує положення вікна та налаштування активного листа
Стилі та формати номерів
Частина стилів (xl/styles.xml) управляється XlsxWorkbookStyles.- Це карта. Style об’єкти з моделі в пам’яті до серіалізованих записів формати шрифту, заповнення, кордону та числа:
BuildStylesheetсеріалізує всі стилі в XMLLoadStylesheetчитає стилі з існуючих файлів XLSXStylesEqualперевіряє, чи будуть два об’єкти стилю виробляти ідентичний XML.
Автофільтрує упаковку
Автофільтрування стану на лист серіалізується за допомогою: XlsxWorkbookAutoFilter:
BuildAutoFilterElementпишеться<autoFilter>Елемент XMLLoadAutoFilterчитає конфігурацію автоматичного фільтрування з частини таблиці роботи
Визначені імена
Названі діапазони і формули упаковані в частину робочого листа та завантажені на XlsxWorkbookDefinedNames:
BuildDefinedNamesзаписує всеDefinedNameзаписи в робочому книзі XMLLoadWorkbookDefinedNamesчитає визначені імена під час завантаження файлів
Поради та найкращі практики
- Використання
Workbook::Save(fileName)як єдиний вихід не викликати напряму класи серіалізатора, якщо це не розширює бібліотеку. - У.
.xlsxФормат є єдиним повністю підтримуваним форматом; збереження до інших форм не доступне в версії 0.1. - Дороги файлів перераховані на:
Workbook(filePath)абоSave(filePath)повинні використовувати роздільник платформи і бути повністю кваліфікованими при роботі в середовищах, де робоча каталогія може змінюватися. - Захист робочого книжка, що застосовується через:
XlsxWorkbookProperties::BuildWorkbookProtectionElementнезалежно від захисту на рівні таблиці, встановленого через:Worksheet::Protect.
Загальні питання
| Issue | Cause | Виправлення |
|---|---|---|
| Файл не завантажується | Недійсний або зашифрований XLSX | Переконайтеся, що файл є простою формою (не захищеної паролем) XLSX |
| Стілі втрачені після збереження | Стиль не застосований до збереження | Call Cell::SetStyle(style) до цього Workbook::Save |
| Назва, що не визначена після переїзду в ту та іншу сторону. | Обсяг встановлений на неправильний лист | Використання DefinedName::SetFormula з повним діапазоном адреси |
Реферат на API
| Клас/метод | Description |
|---|---|
Workbook(filePath) | Завантажити файл XLSX |
Workbook::Save(fileName) | Заховувати на XLSX |
XlsxWorkbookSerializer::Save | Внутрішній: серіалізує модель на Open XML |
XlsxWorkbookSerializer::Load | Внутрішній: десериалізує відкритий XML до моделі |
XlsxDocumentProperties | Опаковка основних та розширених документів з власністю |
XlsxWorkbookProperties | Серіалізація метаданих та налаштувань робочого книжка |
XlsxWorkbookStyles | Упаковка стилевого листка |
XlsxWorkbookAutoFilter | Автоматичний фільтр пакування XML |
XlsxWorkbookDefinedNames | Означений ім’я XML-пакетування |