Travailler avec le Spreadsheet Management

Le Workbook classe est le point d’entrée pour toutes les opérations de feuille de travail dans Aspose.Cells FOSS pour C++. Il fournit des méthodes pour créer de nouveaux livres de travaux, charger les fichiers XLSX existants, gérer les feuilles de cours et sauver le résultat.

Créer un nouveau livre de travail

Instantané Workbook Pour créer un livre de travail vide. une feuille de travaux par défaut est créée automatiquement.

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Summary");
    workbook.Save("output.xlsx");
    return 0;
}

Créer un livre de travail existant

Passez un fichier à la route de Workbook Constructeur pour charger un fichier XLSX existant. Après le chargement, les feuilles de travail et les données cellulaires sont accessibles immédiatement.

Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");

Configuration des propriétés de feuille de travail

Le Worksheet classe exposé les propriétés d’affichage et de protection. Utilisez-les pour configurer la visibilité des feuilles, l’écran réseau, le zoom et la couleur du panneau.

Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);

Protéger et ne pas protégeer un feuillet de travail

Appel à Worksheet::Protect pour fermer un feuille contre les éditions, et Worksheet::Unprotect Pour supprimer la protection :

sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");

Assurer un feuillet unique et une portée de nom définie

Lorsque vous ajoutez plusieurs feuilles de travail programmés, utilisez Workbook::EnsureUniqueSheetName Pour éviter les collisions de nom.Utiliser Workbook::EnsureValidDefinedNameScope Pour vérifier que les noms définis sont correctement décorés.

workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();

Économiser un livre de travail

Appel à Workbook::Save(fileName) Pour écrire le livre de travail sur un disque. Multiple overloads accepte un nom de fichier, un flux ou une explicite SaveFormat.

workbook.Save("products.xlsx");

Conseils et meilleures pratiques

Toujours appeler Workbook::Dispose() Lorsqu’il est fait avec un livre de travail pour libérer les ressources non gérées.
Les noms de feuilles de travail doivent être uniques dans un livre de travaux — utilisation EnsureUniqueSheetName Après les additions de batch.
Sélection Worksheet::SetShowGridlines(false) Pour les feuilles de style présentation pour améliorer la lecture.
Utiliser Worksheet::SetZoom(value) Pour définir un niveau de zoom par défaut (percentage) pour les vues du feuille de travail.
Les couleurs de la table sont attribuées par Worksheet::SetTabColor Aider les utilisateurs à distinguer visuellement les feuilles de travail.

Les problèmes communs

Problème	Cause	Fixé
Fichiers non trouvés sur charge	Un chemin incorrect	Utilisez un itinéraire absolu ou vérifiez le catalogue de travail
Nom de la collision	Duplicer les noms lors de l’ajout des feuilles	Appel à `EnsureUniqueSheetName()` Après chaque addition
Les changements de livre ne sont pas sauvés	`Save` Pas appelé	Toujours appeler `workbook.Save(path)` Avant le départ
Mémoire de l’alerte	`Dispose` Pas appelé	Appel à `workbook.Dispose()` À la fin du scope

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

Classes / Méthodes	Description
`Workbook()`	Créer un nouveau livre de travail vide
`Workbook(filePath)`	Télécharger un fichier XLSX existant
`Workbook::Save(fileName)`	Économisez le livre de travail sur disque
`Workbook::EnsureUniqueSheetName()`	Résoudre les noms de dos dupliqués
`Workbook::Dispose()`	libérer les ressources
`Worksheet::SetName(name)`	Renouveler le feuilleton de travail
`Worksheet::SetShowGridlines(bool)`	Vidéos de la ligne Toggles
`Worksheet::SetZoom(percent)`	Déterminer le pourcentage de zoom
`Worksheet::Protect(password)`	Fermer le feuilleton de travail
`Worksheet::Unprotect(password)`	Débarrassez le feuilleton de travail

Travailler avec le Spreadsheet Management