Travailler avec XLSX Packaging
Travailler avec XLSX Packaging
Aspose.Cells FOSS for C++ reads and writes the .xlsx Open XML format via une couche de sérialisation dédiée. XlsxWorkbookSerializer Les orchestres de classe chargent et sauvegardent toutes les pièces du livre d’oeuvre, y compris des feuilles de travail, styles, noms définis, propriétés de document et filtres automatiques.
Réserver et télécharger les fichiers XLSX
Utilisez le Workbook classe pour toutes les charges et les opérations d’économie. à l’intérieur, XlsxWorkbookSerializer Mettre en œuvre le package XML ouvert :
#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;
}Propriétés du document
Les fichiers XLSX portent des propriétés de document coraux et étendues (titre, auteur, date de création). XlsxDocumentProperties,qui construit et charge les docProps/core.xml et docProps/app.xml Les parties :
| partie | Géré par | contenant |
|---|---|---|
docProps/core.xml | XlsxDocumentProperties::BuildCorePropertiesDocument | Titre, auteur, créé et modifié |
docProps/app.xml | XlsxDocumentProperties::BuildExtendedPropertiesDocument | Nom de la version, Version |
Les métaphores et les paramètres de travail
Les métadonnées au niveau du livre de travail — paramètres de calcul, vues des livres et protection du Livre de travaux — sont gérées par XlsxWorkbookProperties:
BuildWorkbookPropertiesElement- écrire les paramètres de calcul et d’itération du livre de travailBuildWorkbookProtectionElement- Écrire la protection de mot de passe au niveau du workbookBuildBookViewsElement- écrire la position de fenêtre et les paramètres de feuille active
Formats et modèles numériques
Les modèles (xl/styles.xmlest géré par XlsxWorkbookStyles.Il a des cartes Style Objets du modèle in-mémory à la lettre sérialisée, remplir, limite et enregistrement numérique :
BuildStylesheet- sérialiser tous les styles vers XMLLoadStylesheet- Lire les styles d’un fichier XLSX existantStylesEqual- vérifier si deux objets de style produisent des XML identiques
Emballage de filtre automatique
L’état de filtre automatique par feuille de travail est sérialisé par XlsxWorkbookAutoFilter:
BuildAutoFilterElement- écrit le<autoFilter>Élément XMLLoadAutoFilter- Lire la configuration du filtre automatique à partir d’une partie de feuille de travail
Nom définis
Les rangs et les formules nommés sont emballés dans la partie du livre de travail et chargés par XlsxWorkbookDefinedNames:
BuildDefinedNames- écrit toutDefinedNameEntrée dans le livre de travail XMLLoadWorkbookDefinedNames- Lire les noms définis pendant le chargement des fichiers
Conseils et meilleures pratiques
- Utiliser
Workbook::Save(fileName)comme le seul point de sortie — ne pas invocer les classes sérialisateurs directement sauf si vous étendrez la bibliothèque. - Le
.xlsxLe format est le seul format entièrement supporté ; sauvegarde pour d’autres formats n’est pas disponible dans v0.1. - Les fichiers passés à
Workbook(filePath)ouSave(filePath)Il doit utiliser le séparateur de route de la plateforme et être pleinement qualifié lorsqu’il fonctionne dans des environnements où le catalogue de travail peut varier. - Protection du livre de travail appliquée par le biais
XlsxWorkbookProperties::BuildWorkbookProtectionElementest indépendant de la protection du niveau des feuilles d’œuvre établie parWorksheet::Protect.
Les problèmes communs
| Problème | Cause | Fixé |
|---|---|---|
| Fichiers échouent à charger | Invalid ou crypté XLSX | Assurez-vous que le fichier est un simple (non protégé par mot de passe) XLSX |
| Les styles perdus après sauvetage | Style n’a pas été appliqué avant de sauvegarder | Appel à Cell::SetStyle(style) Avant Workbook::Save |
| Les noms qui manquent après le tour de l’avion | L’étendue fixée à la mauvaise feuille | Utiliser DefinedName::SetFormula Avec une adresse à large gamme |
Le résumé de référence API
| Classes / Méthodes | Description |
|---|---|
Workbook(filePath) | Téléchargez un fichier XLSX |
Workbook::Save(fileName) | Économiser sur XLSX |
XlsxWorkbookSerializer::Save | Internal : sérialiser le modèle à Open XML |
XlsxWorkbookSerializer::Load | Internal : désertifie Open XML pour modéliser |
XlsxDocumentProperties | Package de propriété documenté et étendu |
XlsxWorkbookProperties | Les métadonnées du livre de travail et la sérialisation des paramètres |
XlsxWorkbookStyles | Style de packaging |
XlsxWorkbookAutoFilter | Filtre automatique XML |
XlsxWorkbookDefinedNames | Emballage XML nom définit |