Com treballar amb la configuració de l' objectari central en .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (sistema de data i lloc), Workbook.DocumentProperties (metadades de l’autor), Workbook.LoadDiagnostics (informe de reparació), i SaveOptions Instal·lar amb: dotnet add package Aspose.Cells_FOSS.

Guia de pas a pas

Pas 1: Instal·la el paquet

dotnet add package Aspose.Cells_FOSS

Pas 2: Importeu l’espai de noms

using Aspose.Cells_FOSS;
using System.Globalization;

Pas 3: Configuració de la configuració del llibre de treball

Workbook.Settings retorna un WorkbookSettings object. Set Date1904 = true per als arxius d’origen macOS que utilitzen el sistema de data 1904. Set. Culture per controlar el nombre i la data de l’anàlisi 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);

Pas 4: Configurar propietats del document

Workbook.DocumentProperties exposicions Title, Subject, Author, Keywords, Comments, Category, Company, i Manager com a propietats directes de cadena.

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

Pas 5: Utilitzar SaveOptions

Workbook.Save(path, SaveOptions) accepta una SaveOptions Objectes per personalitzar la sortida.: UseSharedStrings (redueix la mida del fitxer per a les fulles amb cadenes repetides), ValidateBeforeSave (corre la validació abans de l’escriptura), i CompactStyles (elimina els estils no utilitzats).

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


---

### Pas 6: Llegir el diagnòstic de càrrega després de la reparació

Després de la càrrega amb `TryRepairPackage = true`, comprovar `Workbook.LoadDiagnostics` per veure si es van aplicar alguna reparació.

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

<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“Copy code”

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Problemes comuns i fixos

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

Propietats del document no visibles en el panell d’informació de fitxer d"Excel. Assegureu-vos que estàs posant propietats en Workbook.DocumentProperties, no Workbook.Properties.Aquest darrer conté banderes d’exposició, no cadenes de metadades.

Date1904 = true causa que els valors de data es desplacin. Date1904 modifica l’època utilitzada per als números de sèrie de data. Només configurar-la en true per als arxius que es van originar a partir de macOS Excel amb el sistema de data 1904 activat; els sistemes d’engrunatge provoquen errors fora del 1462 dia.

Preguntes freqüents

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

WorkbookSettings (via Workbook.Settings) conté valors de configuració com ara: Date1904 i de la Culture. WorkbookProperties (via Workbook.Properties) conté les banderes d’exhibició OOXML com ara: ShowObjects.Les cadenes de metadades del document (títol, autor, etc.) es troben en el sistema d’identificació. Workbook.DocumentProperties.

Does `CompactStyles` mai treure els estils que necessito?

No, no ho sé. CompactStyles només elimina els estils que no estan referenciats per cap cèl·lula o regla de format del llibre.

Puc llegir-te? `LoadDiagnostics` fins i tot quan no es va intentar reparar?

Sí, el… Issues la col·lecció serà buida i ambdues HasRepairs i de la HasDataLossRisk tornarà. false.