Com treballar amb la configuració principal del llibre de treball a .NET

Aspose.Cells FOSS per a .NET exposa la configuració a nivell de llibre de treball a través de Workbook.Settings (idioma i sistema de dates), Workbook.DocumentProperties (metadades de l’autor), Workbook.LoadDiagnostics (informe de reparació) i SaveOptions (comportament de desament). Instal·la amb dotnet add package Aspose.Cells_FOSS.

Guia pas a pas

dotnet add package Aspose.Cells_FOSS

using Aspose.Cells_FOSS;
using System.Globalization;

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);

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);

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.");

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}");

Problemes comuns i solucions

WorkbookSaveException quan ValidateBeforeSave = true. El llibre de treball conté una inconsistència estructural. Desactiva ValidateBeforeSave temporalment per desar i inspeccionar el fitxer, i després corregeix el contingut problemàtic.

Propietats del document no visibles al panell d’Informació del fitxer d’Excel.
Assegureu-vos que esteu establint les propietats a Workbook.DocumentProperties, no a Workbook.Properties. Aquest darrer conté banderes de visualització, no cadenes de metadades.

Date1904 = true causa que els valors de data es desplacin.
Date1904 canvia l’època utilitzada per als números de sèrie de data. Només establiu‑lo a true per a fitxers que van originar‑se a macOS Excel amb el sistema de dates 1904 activat; barrejar sistemes provoca errors de 1462 dies.

Preguntes freqüents

Quina és la diferència entre WorkbookSettings i WorkbookProperties?

WorkbookSettings (via Workbook.Settings) conté valors de configuració com Date1904 i Culture. WorkbookProperties (via Workbook.Properties) conté banderes de visualització OOXML com ShowObjects. Les cadenes de metadades del document (Títol, Autor, etc.) es troben a Workbook.DocumentProperties.

El CompactStyles elimina alguna vegada els estils que necessito?

No. CompactStyles només elimina els estils que no estan referenciats per cap cel·la o regla de format al llibre de treball.

Puc llegir LoadDiagnostics encara que no s’hagi intentat cap reparació?

Sí. La col·lecció Issues estarà buida i tant HasRepairs com HasDataLossRisk retornaran false.

Vegeu també

• Treballant amb la configuració principal del llibre de treball
• Com carregar un full de càlcul a .NET
• Preguntes freqüents