Hogyan dolgozzunk a Core Workbook beállításokkal .NET-ben

Az Aspose.Cells FOSS for .NET a munkafüzet szintű konfigurációt teszi elérhetővé a Workbook.Settings (helyi beállítás és dátumrendszer), Workbook.DocumentProperties (szerző metaadatok), Workbook.LoadDiagnostics (javítási jelentés) és SaveOptions (mentési viselkedés) segítségével. Telepítés a dotnet add package Aspose.Cells_FOSS használatával.

Lépésről lépésre útmutató

1. lépés: A csomag telepítése

dotnet add package Aspose.Cells_FOSS

2. lépés: Névterület importálása

using Aspose.Cells_FOSS;
using System.Globalization;

3. lépés: WorkbookSettings konfigurálása

Workbook.Settings egy WorkbookSettings objektumot ad vissza. Állítsa be Date1904 = true‑t macOS‑ból származó fájlokhoz, amelyek a 1904‑es dátumrendszert használják. Állítsa be Culture‑t a szám‑ és dátumértelmezés helyi beállításának vezérléséhez.

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

4. lépés: Dokumentum tulajdonságainak beállítása

Workbook.DocumentProperties közvetlen string tulajdonságokként teszi elérhetővé Title, Subject, Author, Keywords, Comments, Category, Company és Manager.

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

5. lépés: SaveOptions használata

Workbook.Save(path, SaveOptions) elfogad egy SaveOptions objektumot a kimenet testreszabásához. Kulcsfontosságú tulajdonságok: UseSharedStrings (csökkenti a fájlméretet az ismétlődő karakterláncokkal rendelkező munkalapoknál), ValidateBeforeSave (érvényesítést hajt végre írás előtt), és CompactStyles (eltávolítja a nem használt stílusokat).

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

6. lépés: LoadDiagnostics olvasása javítás után

A TryRepairPackage = true betöltése után ellenőrizze a Workbook.LoadDiagnostics-t, hogy lássa, alkalmaztak‑e javításokat.

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

Gyakori problémák és javítások

WorkbookSaveException amikor ValidateBeforeSave = true.
A munkafüzet szerkezeti ellentmondást tartalmaz. Tiltsa le ValidateBeforeSave ideiglenesen a mentéshez és a fájl ellenőrzéséhez, majd javítsa a problémás tartalmat.

A dokumentumtulajdonságok nem láthatók az Excel Fájl információ paneljén. Győződjön meg róla, hogy a tulajdonságokat a Workbook.DocumentProperties-on állítja be, nem a Workbook.Properties-on. Az utóbbi megjelenítési jelzőket tartalmaz, nem metaadat-karakterláncokat.

Date1904 = true dátumértékek eltolódását okozza. A Date1904 módosítja a dátumsorozatszámokhoz használt epoch-ot. Csak akkor állítsa true értékre, ha a fájlok macOS Excelből származnak, ahol a 1904-es dátumrendszer be van kapcsolva; a rendszerek keverése 1462 napos eltérést okoz.

Gyakran Ismételt Kérdések

Mi a különbség a `WorkbookSettings` és `WorkbookProperties` között?

WorkbookSettings (Workbook.Settings-n keresztül) konfigurációs értékeket tartalmaz, mint például Date1904 és Culture. WorkbookProperties (Workbook.Properties-n keresztül) OOXML megjelenítési jelzőket tartalmaz, például ShowObjects. A dokumentum metaadat-karakterláncok (Cím, Szerző, stb.) a Workbook.DocumentProperties‑ban találhatók.

Eltávolítja valaha a `CompactStyles` a szükséges stílusokat?

Nem. CompactStyles csak azokat a stílusokat távolítja el, amelyekre a munkafüzetben egyetlen cella vagy formázási szabály sem hivatkozik.

Olvashatom a `LoadDiagnostics`‑t akkor is, ha nem történt javítási kísérlet?

Igen. A Issues gyűjtemény üres lesz, és mind a HasRepairs, mind a HasDataLossRisk visszaadja false.