Hvordan man arbejder med kerneindstillinger i .NET-arbejdsbogen

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (lokal- og datoanordning), Workbook.DocumentProperties (metadata om forfatteren), Workbook.LoadDiagnostics (reparationsrapport) og SaveOptions Installering med dotnet add package Aspose.Cells_FOSS.

Trin-for-trin vejledning

Trin 1: Installer pakken

dotnet add package Aspose.Cells_FOSS

Trin 2: Import af navneområdet

using Aspose.Cells_FOSS;
using System.Globalization;

Trin 3: Konfigurer indstillinger i arbejdskasse

Workbook.Settings returnerer en WorkbookSettings Objekt. Date1904 = true for macOS-opbyggede filer, der bruger 1904 dattsystemet. Set Culture til at kontrollere nummer og dato parsering lokalt.

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

Trin 4: Angiv dokumentegenskaber

Workbook.DocumentProperties eksponeringer Title, Subject, Author, Keywords, Comments, Category, Company, og Manager som direkte strengeegenskaber.

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

Trin 5: Brug SaveOptions

Workbook.Save(path, SaveOptions) accepterer en SaveOptions Knappræster: UseSharedStrings (reducerer filstørrelsen for ark med gentagne strenge), ValidateBeforeSave (kører validering før skrivning) og CompactStyles (fjerner ubrugte stilarter).

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

Trin 6: Læs belastningsdiagnostik efter reparation

Efter lastning med: TryRepairPackage = true, tjekke Workbook.LoadDiagnostics at se, om der er foretaget reparationer.

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

Almindelige problemer og løsninger

WorkbookSaveException Hvornår? ValidateBeforeSave = true. Arbejdsmappen indeholder en strukturel uoverensstemmelse. ValidateBeforeSave midlertidigt at gemme og undersøge filen, derefter rette det problematiske indhold.

Dokumentegenskaber ikke synlige i Excel’s filinfo-paneel. Sørg for, at du sætter egenskaber på Workbook.DocumentProperties, ikke Workbook.Properties.Den sidste indeholder visningsflag, ikke metadatastrenge.

Date1904 = true forårsager datumværdierne at skifte. Date1904 ændrer den epoche, der anvendes til datoens serienumre. true for filer, der stammer fra macOS Excel med 1904-datumssystemet aktiveret; blandingssystemer forårsager fejl på 1462 dage.

Ofte stillede spørgsmål

Hvad er forskellen mellem: `WorkbookSettings` og: `WorkbookProperties`?

WorkbookSettings (via: Workbook.Settings) indeholder konfigurationsværdier som: Date1904 og: Culture. WorkbookProperties (via: Workbook.Properties) indeholder OOXML-skærmflagger som f.eks. ShowObjects.Dokumentmetadata-strenge (titel, forfatter osv.) lever i Workbook.DocumentProperties.

- Ja. Det gør det. `CompactStyles` - Har du fjernet stilarter?

Nej, det er ikke. CompactStyles Fjerner kun stilarter, der ikke er refereret til i en celle eller formatregel i arbejdsmappen.

Må jeg læse? `LoadDiagnostics` selv om ingen forsøg blev gjort?

Ja, det er den. Issues Samlingen er tom og begge dele af den samme samling. HasRepairs og: HasDataLossRisk vil vende tilbage false.