Comment travailler avec les paramètres de livre de travail dans .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (local et système de date), Workbook.DocumentProperties (Auteur des données métalliques), Workbook.LoadDiagnostics (Réparation de la réforme) et SaveOptions (Save behavior) Installation avec dotnet add package Aspose.Cells_FOSS.

Guide étape par étapes

Étape 1 : Installer le package

dotnet add package Aspose.Cells_FOSS

Étape 2 : Importer le nom de l’espace

using Aspose.Cells_FOSS;
using System.Globalization;

Étape 3 : Configurer les paramètres de Workbook

Workbook.Settings Retour à A WorkbookSettings Objet : Set Date1904 = true pour les fichiers macOS originaux qui utilisent le système de date 1904. Culture Pour contrôler le nombre et la date de partage local.

using Aspose.Cells_FOSS;
using System.Globalization;

var wb = new Workbook();
wb.Settings.Date1904 = false;
wb.Settings.Culture = new CultureInfo("en-US");
wb.Worksheets[0].Cells["A1"].PutValue("Settings configured");
wb.Save("settings.xlsx");

var loaded = new Workbook("settings.xlsx");
Console.WriteLine("Date1904: " + loaded.Settings.Date1904);

Étape 4 : Définir les propriétés de document

Workbook.DocumentProperties Expositions Title, Subject, Author, Keywords, Comments, Category, Company,et Manager comme propriétés de la ligne directe.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.DocumentProperties.Title = "Quarterly Report";
wb.DocumentProperties.Author = "Reporting Team";
wb.DocumentProperties.Company = "Contoso Ltd";
wb.DocumentProperties.Keywords = "quarterly, sales, 2026";
wb.Save("properties.xlsx");

var loaded = new Workbook("properties.xlsx");
Console.WriteLine("Title: " + loaded.DocumentProperties.Title);
Console.WriteLine("Author: " + loaded.DocumentProperties.Author);

Étape 5 : Utilisez les options de sauvegarde

Workbook.Save(path, SaveOptions) accepter A SaveOptions Pour la mise en place de l’électricité, les propriétés clés : UseSharedStrings (Réduit la taille du fichier pour les feuilles avec des filets répétés), ValidateBeforeSave (l’écriture est valide avant la rédaction) et CompactStyles (Révoquer les styles inutilisés).

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];
for (var i = 0; i < 50; i++)
    ws.Cells[i, 0].PutValue("Repeated text");

var opts = new SaveOptions
{
    UseSharedStrings = true,
    ValidateBeforeSave = true,
    CompactStyles = true,
};

wb.Save("compact.xlsx", opts);
Console.WriteLine("Saved with SaveOptions.");

Étape 6 : Lire le diagnostic de charge après réparation

Après le chargement avec TryRepairPackage = true,et vérifier Workbook.LoadDiagnostics Pour voir si des réparations ont été effectuées.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
var diag = wb.LoadDiagnostics;

Console.WriteLine("HasRepairs: " + diag.HasRepairs);
Console.WriteLine("HasDataLossRisk: " + diag.HasDataLossRisk);
foreach (var entry in diag.Issues)
    Console.WriteLine($"  [{entry.Severity}] {entry.Code}: {entry.Message}");

Problèmes communs et fixations

WorkbookSaveException Quand ValidateBeforeSave = true. Le livre de travail contient une inconsistance structurelle. ValidateBeforeSave temporairement pour sauvegarder et inspecter le fichier, puis corriger le contenu problématique.

Les propriétés de document ne sont pas visibles dans le panneau Info des fichiers d’Excel. Assurez-vous que vous avez des propriétés sur Workbook.DocumentProperties,Non pas Workbook.Properties.Ce dernier tient des drapeaux d’affichage, pas des filets de métadonnées.

Date1904 = true Les valeurs de date sont à changer. Date1904 modifie l’époque utilisée pour les numéros de série date. true pour les fichiers originaires de macOS Excel avec le système date 1904 activé; systèmes de mélange provoquent des erreurs off-by-1462 jours.

Questions fréquemment posées

Quelle est la différence entre `WorkbookSettings` et `WorkbookProperties`?

WorkbookSettings (à travers le Workbook.SettingsIl contient des valeurs de configuration comme Date1904 et Culture. WorkbookProperties (à travers le Workbook.PropertiesIl contient des drapeaux de l’affichage OOXML comme : ShowObjects.Les filets de métadonnées (titre, auteur, etc.) sont en direct dans le document. Workbook.DocumentProperties.

Le fait `CompactStyles` Avez-vous jamais retiré les styles dont j’ai besoin ?

Non pas. CompactStyles Il ne supprime que les styles qui n’ont pas été mentionnés par aucune règle cellulaire ou format dans le livre de travail.

Je peux lire `LoadDiagnostics` Même si aucune réparation n’a été tentée.?

Oui, le Issues La collection sera vide et les deux HasRepairs et HasDataLossRisk Il reviendra false.