Travailler avec XLSX Packaging

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 :

partieGéré parcontenant
docProps/core.xmlXlsxDocumentProperties::BuildCorePropertiesDocumentTitre, auteur, créé et modifié
docProps/app.xmlXlsxDocumentProperties::BuildExtendedPropertiesDocumentNom 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 travail
  • BuildWorkbookProtectionElement - Écrire la protection de mot de passe au niveau du workbook
  • BuildBookViewsElement - é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 XML
  • LoadStylesheet - Lire les styles d’un fichier XLSX existant
  • StylesEqual - 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 XML
  • LoadAutoFilter - 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 tout DefinedName Entrée dans le livre de travail XML
  • LoadWorkbookDefinedNames - 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 .xlsx Le 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) ou Save(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::BuildWorkbookProtectionElement est indépendant de la protection du niveau des feuilles d’œuvre établie par Worksheet::Protect.

Les problèmes communs

ProblèmeCauseFixé
Fichiers échouent à chargerInvalid ou crypté XLSXAssurez-vous que le fichier est un simple (non protégé par mot de passe) XLSX
Les styles perdus après sauvetageStyle n’a pas été appliqué avant de sauvegarderAppel à Cell::SetStyle(style) Avant Workbook::Save
Les noms qui manquent après le tour de l’avionL’étendue fixée à la mauvaise feuilleUtiliser DefinedName::SetFormula Avec une adresse à large gamme

Le résumé de référence API

Classes / MéthodesDescription
Workbook(filePath)Téléchargez un fichier XLSX
Workbook::Save(fileName)Économiser sur XLSX
XlsxWorkbookSerializer::SaveInternal : sérialiser le modèle à Open XML
XlsxWorkbookSerializer::LoadInternal : désertifie Open XML pour modéliser
XlsxDocumentPropertiesPackage de propriété documenté et étendu
XlsxWorkbookPropertiesLes métadonnées du livre de travail et la sérialisation des paramètres
XlsxWorkbookStylesStyle de packaging
XlsxWorkbookAutoFilterFiltre automatique XML
XlsxWorkbookDefinedNamesEmballage XML nom définit

Voir aussi

 Français